PEAR Manual
PrevNext

DB_NestedSet::getParent()

DB_NestedSet::getParent()  -- Fetch the immediate parent of a node given by id

Synopsis

require_once 'DB/NestedSet.php';

mixed DB_NestedSet::getParent (int $id, bool [$keepAsArray = FALSE], bool [$aliasFields = TRUE], array [$addSQL = array()], [$useDB = TRUE])

Description

This package is not documented yet.

Parameter

integer $id

The node ID

boolean $keepAsArray

(optional) Keep the result as an array or transform it into a set of DB_NestedSet_Node objects?

boolean $aliasFields

(optional) Should we alias the fields so they are the names of the parameter keys, or leave them as is?

array $addSQL

(optional) Array of additional params to pass to the query.

$useDB

Return value

returns False on error, or the parent node

See

see _addSQL

Throws

throws no exceptions thrown

Note

This function can not be called statically.

Example

Example 36-1. Get Parent

Fetch the immediate parent of a node given by id. GetParent will return $parent2 as $data.

require_once('DB/NestedSet.php');
    $nestedSet =& DB_NestedSet::factory('DB', $dsn, $params);
    $parent = $nestedSet->createRootNode(array('name' => 'root-node'), false, true);
    $parent2 = $nestedSet->createSubNode($parent, array('name' => 'sub-node));
    $nestedSet->createSubNode($parent2, array('name' => 'sub1'));
    $nestedSet->createSubNode($parent2, array('name' => 'sub2'));
    $data = $nestedSet->getParent($parent2);
PrevHomeNext
DB_NestedSet::getChildren()UpDB_NestedSet::getParents()