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)
