PEAR Manual
PrevNext

DB_NestedSet::createRootNode()

DB_NestedSet::createRootNode()  --  Creates a new root node. If no id is specified then it is either added to the beginning/end of the tree based on the $pos.

Synopsis

require_once 'DB/NestedSet.php';

mixed DB_NestedSet::createRootNode (array $values, integer [$id = FALSE], bool [$first = FALSE], string [$pos = NESE_MOVE_AFTER])

Description

Optionally it deletes the whole tree and creates one initial rootnode


 +-- root1 [target]
 |
 +-- root2 [new]
 |
 +-- root3
  

Parameter

array $values

Hash with param => value pairs of the node (see $this->params)

integer $id

ID of target node (the rootnode after which the node should be inserted)

boolean $first

Danger: Deletes and (re)inits the whole tree - sequences are reset

string $pos

The position in which to insert the new node.

Return value

returns The node id or false on error

Throws

throws no exceptions thrown

Note

This function can not be called statically.

Example

Example 36-1. Create rootnodes

require_once('DB/NestedSet.php');
    $nestedSet =& DB_NestedSet::factory('DB', $dsn, $params);
    $nestedSet->createRootNode(array('name' => 'rootnode'), false, true);
PrevHomeNext
DB_NestedSet::createRightNode()UpDB_NestedSet::createSubNode()