ptree_get_root

- get the root node handle

Synopsis

cc [ flag... ] file... -lpicltree [ library... ]
#include <picltree.h>

int ptree_get_root(picl_nodehdl_t *nodeh);

Description

The ptree_get_root() function copies the handle of the root node of the PICL tree into the location specified by nodeh.

Return Values

Upon successful completion, 0 is returned. On failure, a non-negative integer is returned to indicate an error.

Errors

PICL_INVALIDARG

Invalid argument

PICL_FAILURE

General system failure

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

libpicltree(3PICLTREE), ptree_create_node(3PICLTREE), attributes(5)