PHP Classes

Buffer tree: Manage ordered collections of data items

Recommend this page to a friend!
Stumble It! Stumble It! Bookmark in Bookmark in
  Info   View files Example   View files View files (7)   DownloadInstall with Composer Download .zip   Reputation   Support forum   Blog    
Last Updated Ratings Unique User Downloads Download Rankings  
2014-03-09 (1 year ago) RSS 2.0 feedNot yet rated by the usersTotal: 139 All time: 7,868 This week: 1,101Up
Version License PHP version Categories  
buffer-tree 1.7GNU Lesser Genera...5.2PHP 5, Data types
Description Author  

This package can manage ordered collections of data items.

It provides a class can that can append, replace and find arbitrary values in a buffer.

Another class can perform operations to manage a tree of buffers like entering a new buffer, activate a previous buffer, write data to the current buffer, or find a buffer by name.

Picture of Roger Baklund
  Performance   Level  
Name: Roger Baklund is available for providing paid consulting. Contact Roger Baklund .
Classes: 6 packages by
Country: Norway Norway
Age: 49
All time rank: 19907 in Norway Norway
Week rank: 1643 Up7 in Norway Norway Equal
Innovation award
Innovation award
Nominee: 3x


Buffer tree

Two PHP classes for creating and manipulating a hierarchy of output buffers.

The class buffer represents a single buffer, it has a name, a list of content and an optional separator. The list of content consists of other buffers and data. The following methods are defined:

append($data)   -- append data (including buffer or array) to this buffer
clear()         -- clear this buffer
replace($data)  -- replace this buffer with new data
find($name)     -- find a named buffer within this buffer
dump()          -- make visual output of this buffer (for debugging)
__toString()    -- output buffer content as a string

The second class buffer_manager has methods for managing a stack of buffers.

current()       -- return current buffer instance
enter($name)    -- activate named buffer, if it does not exist: create and append to current buffer
leave()         -- leave current buffer, activate previous active buffer
out($data)      -- write data (string, buffer or array) to current active buffer
undo()          -- remove current (newly created) buffer
find($name)     -- find named buffer within root buffer

There are two demo files provided for each class, showing examples of how these classes can be used.

  • buffer_demo_1: Creating and manipulating a table of integers, using different separators
  • buffer_demo_2: Creating HTML output, using buffers as templates
  • buffer_manager_demo_1: Using the buffer manager for better control of HTML output
  • buffer_manager_demo_2: More advanced examples of HTML template usage

Note that the first example is very different from the others. The buffer class is very generic, it does not need to contain strings as values. However the __toString() method will automatically cast each content member to a string. This means you can use any scalars and even objects as data items, as long as they can be cast to strings, i.e. they have a __toString() method.

  Files folder image Files  
File Role Description
Files folder imagedemo (4 files)
Plain text file buffer.class.php Class Defines the buffer class
Plain text file buffer_manager.class.php Class Defines the buffer_manager class
Accessible without login Plain text file Doc. Documentation

  Files folder image Files  /  demo  
File Role Description
  Accessible without login Plain text file buffer_demo_1.php Example Example script
  Accessible without login Plain text file buffer_demo_2.php Example Example script
  Accessible without login Plain text file buffer_manager_demo_1.php Example Example script
  Accessible without login Plain text file buffer_manager_demo_2.php Example Example script

 Version Control Unique User Downloads Download Rankings  
 100%Total:139All time:7,868
 This week:0This week:1,101Up