Re: New GtkTreeModel functionality

> Over the last couple of days I have implemented some additional  
> functionality for GtkTreeModel derived stores (list and tree), which  
> is not present in Gtk+. Basically, the tree model and rows can now  
> function as iterators and arrays. Here is a sample script  
> illustrating what can be done. There may be a bug or two there to  
> chase down, and maybe a couple of small things to add, but so far it  
> is pretty stable and, I think, cool.
>
> -Andrei
>
> <?php
>
> // A little demo of the new functionality
>
> // create our tree store
> $store = new GtkTreeStore(Gtk::TYPE_STRING, Gtk::TYPE_LONG);
>
> // add some rows
> $root  = $store->append(null, array('root', 2));
> $child = $store->append($root, array('child1', 3));
> $child2 = $store->append($root, array('child2', 5));
> $child3 = $store->append($child, array('child1-1', 7));
> $child4 = $store->append($child, array('child1-2', 11));
> $child5 = $store->append($child, array('child1-3', 13));
> $child6 = $store->append($child4, array('child1-2-1', 17));
> print_tree($store);
>
> // get the first row in the tree model (all equivalent)
> $row = $store[0];
> $row = $store['0'];
> $row = $store[array(0)];
> $iter = $store->get_iter(0);
> $row = $store[$iter];
>
> // get the row with label child1-2
> $row = $store['0:0:1'];
> $row = $store[array(0, 0, 1)];
> $iter = $store->get_iter('0:0:1');
> $row = $store[$iter];
>
> // check if a row exists
> var_dump(isset($store['0:0'])); // yes, it does
> var_dump(isset($store['0:2'])); // no, it doesn't
>
> // how many top-level rows do we have?
> var_dump(count($store)); // 1, of course, but more if we had a list  
> store
>
> // how many columns do we have?
> var_dump(count($store[0])); // 2
>
> // you can set new values in an existing row
> // here we change child1-3 row
> $store['0:0:2'] = array('CHILD1-3', 1313);
> print_tree($store);
>
> // you can also delete rows
> // let's delete child1-2-1
> unset($store['0:0:1:0']);
> print_tree($store);
>
> // you can use the store directly in foreach()
> // it will iterate over the top level rows (only 1 in tree model, of  
> course)
> // each value is an object of class GtkTreeModelRow
> foreach ($store as $row)
> {
>      // work on each row here
> }
>
> // GtkTreeModelRow is special too
> // you can obtain all kinds of info from it
> $row = $store['0:0:0']; // get child1-1 row
>
> // first of all, you can access it as an array
> // where index corresponds to a column
> var_dump($row[0], $row[1]); // outputs 'child1-1' and 7
>
> // you can also change column values through it
> $row[1] += 100; // here we added a 100 to its second column value
> var_dump($row[0], $row[1]); // outputs 'child1-1' and 107
>
> // you can even use list() with it
> list($label, $num) = $store['0:1'];
> var_dump($label, $num); // outputs 'child2' and 5
>
> // sometimes it's easier to access grab a specific column from a  
> specific row
> var_dump($store['0:0:2'][1]); // outputs 1313
> // let's change it again
> $store['0:0:2'][1] *= 3;
> var_dump($store['0:0:2'][1]); // outputs 3939
>
> // what else can we get from GtkTreeModelRow..
> $row = $store['0:0:1']; // child1-1 row
> $model  = $row->model;  // well, that's obvious
> $next   = $row->next;   // its next sibling, in this case child1-2
> $parent = $row->parent; // its parent, in this case child1
> $iter   = $row->iter;   // the GtkTreeIter for the row
> $path   = $row->path;   // and the path for the row (as an array)
>
> // we can also get at the children of the row
> // the result is an object of type GtkTreeModelRowIter
> // which we can use in foreach()
> $row = $store['0:0'];
> foreach ($row->children() as $child) {
>      // work on the child row
>      $child[0] .= '!';
> }
> print_tree($store);
>
> // That's all folks! (for now)
>
>
>
> // helper function
> function print_tree($iter, $level = 0)
> {
>      foreach ($iter as $row) {
>          printf("%s%s (%d)\n", str_repeat("  ", $level), $row[0], $row
> [1]);
>          print_tree($row->children(), $level+1);
>      }
> }
>
> ?>
>