PICL Plug-In Library Functions ptree_add_node(3PICLTREE)
NAME
ptree_add_node, ptree_delete_node - add or delete node to or
from treeSYNOPSIS
cc [ flag... ] file... -lpicltree [ library... ]
#include
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 thehandle 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, anon-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 reini-
tialized.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
SunOS 5.11 Last change: 28 Mar 2000 1
PICL Plug-In Library Functions ptree_add_node(3PICLTREE)
PICL_FAILURE General system failure
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Interface Stability | Committed ||_____________________________|_____________________________|
| MT-Level | MT-Safe |
|_____________________________|_____________________________|
SEE ALSO
attributes(5)SunOS 5.11 Last change: 28 Mar 2000 2