1ptree_add_node(3PICLTREE)PICL Plug-In Library Functionsptree_add_node(3PICLTREE)
2
3
4

NAME

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

SYNOPSIS

9       cc [ flag... ] file... -lpicltree [ library... ]
10       #include <picltree.h>
11
12       int ptree_add_node(picl_nodehdl_t parh, picl_nodehdl_t chdh);
13
14
15       int ptree_delete_node(ptree_delete_node nodeh);
16
17

DESCRIPTION

19       The ptree_add_node() function adds the node specified by handle chdh as
20       a child node to the node specified by the handle parh.  PICL_CANTPARENT
21       is if the child node already has a parent.
22
23
24       The  ptree_delete_node()  function deletes the node specified by handle
25       nodeh and all its descendant nodes from the tree.
26

RETURN VALUES

28       Upon successful completion, 0 is returned. On failure,  a  non-negative
29       integer is returned to indicate an error.
30
31
32       PICL_STALEHANDLE  is  returned  if  the handle is no longer valid. This
33       occurs if the PICL tree was refreshed or reinitialized.
34
35
36       PICL_INVALIDHANDLE is returned if the specified handle never existed.
37

ERRORS

39       PICL_NOTNODE          Node a node
40
41
42       PICL_CANTPARENT       Already has a parent
43
44
45       PICL_TREEBUSY         PICL tree is busy
46
47
48       PICL_INVALIDHANDLE    Invalid handle
49
50
51       PICL_STALEHANDLE      Stale handle
52
53
54       PICL_FAILURE          General system failure
55
56

ATTRIBUTES

58       See attributes(5) for descriptions of the following attributes:
59
60
61
62
63       ┌─────────────────────────────┬─────────────────────────────┐
64       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
65       ├─────────────────────────────┼─────────────────────────────┤
66       │Interface Stability          │Evolving                     │
67       ├─────────────────────────────┼─────────────────────────────┤
68       │MT-Level                     │MT-Safe                      │
69       └─────────────────────────────┴─────────────────────────────┘
70

SEE ALSO

72       attributes(5)
73
74
75
76SunOS 5.11                        28 Mar 2000        ptree_add_node(3PICLTREE)
Impressum