DB_NestedSet::convertTreeModel (Previous) (Next) DB_NestedSet::createRightNode
View this page in Last updated: Sun, 28 Sep 2008
English | French | German | Japanese | Plain HTML

DB_NestedSet::createLeftNode()

DB_NestedSet::createLeftNode()  -- Creates a node before a given node

Synopsis

require_once 'DB/NestedSet.php';

mixed DB_NestedSet::createLeftNode (int $id, array $values, bool $returnID)

Beschreibung


 +-- root1
 |
 +-\ root2
 | |
 | |-- subnode2 [new]
 | |-- subnode1 [target]
 | |-- subnode3
 |
 +-- root3

Parameter

integer $id

Target node ID

array $values

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

boolean $returnID

Tell the method to return a node id instead of an object. ATTENTION: That the method defaults to return an object instead of the node id has been overseen and is basically a bug. We have to keep this to maintain BC. You will have to set $returnID to TRUE to make it behave like the other creation methods. This flaw will get fixed with the next major version.

Rückgabewert

returns The node id or false on error

Fehler-Meldungen

throws no exceptions thrown

Hinweise

Diese Methode kann nicht statisch aufgerufen werden.

Beispiel

Beispiel 39-1. Create left node

Firstly, we connect to NestedSet using Factory. Then we create some nodes and finally we create a LeftNode. The LeftNode will be placed leftsided to the first root-node. 


<?php
require_once('DB/NestedSet.php');
    $nestedSet =& DB_NestedSet::factory('DB', $dsn, $params);
    $parent = $nestedSet->createRootNode(array('name' => 'root-node'), false, true);
    $nestedSet->createSubNode($parent, array('name' => 'sub1'));
    $nestedSet->createSubNode($parent, array('name' => 'sub2'));
    $nestedSet->createLeftNode($parent, array('name' => 'left node'), true);
?>
DB_NestedSet::convertTreeModel (Previous) (Next) DB_NestedSet::createRightNode
Download Documentation Last updated: Sun, 28 Sep 2008
Do you think that something on this page is wrong? Please file a bug report or add a note.
User Notes:
There are no user contributed notes for this page.