PTREE_ADD_NODE(3PICLTREE) PICL Plug-In Library Functions

NAME

ptree_add_node, ptree_delete_node - add or delete node to or from
tree

SYNOPSIS

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

int ptree_add_node(picl_nodehdl_t parh, picl_nodehdl_t chdh);


int ptree_delete_node(ptree_delete_node nodeh);

DESCRIPTION

The ptree_add_node() function adds the node specified by handle chdh
as a child node to the node specified by the handle parh.
PICL_CANTPARENT is if the child node already has a parent.


The ptree_delete_node() function deletes the node specified by handle
nodeh and all its descendant nodes from the tree.

RETURN VALUES

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


PICL_STALEHANDLE is returned if the handle is no longer valid. This
occurs if the PICL tree was refreshed or reinitialized.


PICL_INVALIDHANDLE is returned if the specified handle never existed.

ERRORS

PICL_NOTNODE
Node a node


PICL_CANTPARENT
Already has a parent


PICL_TREEBUSY
PICL tree is busy


PICL_INVALIDHANDLE
Invalid handle


PICL_STALEHANDLE
Stale handle


PICL_FAILURE
General system failure

ATTRIBUTES

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


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO

attributes(7)

March 28, 2000 PTREE_ADD_NODE(3PICLTREE)