1ptree_create_and_add_nodeP(I3CPLICPLlTuRgE-EI)n LibrarpytrFeuen_cctrieoantse_and_add_node(3PICLTREE)
2
3
4
6 ptree_create_and_add_node - create and add node to tree and return node
7 handle
8
10 cc [ flag... ] file... -lpicltree [ library... ]
11 #include <picltree.h>
12
13 int ptree_create_and_add_node(picl_nodehdl_t parh,
14 const char *name, const char *classname,
15 picl_nodehdl_t *nodeh);
16
17
19 The ptree_create_and_add_node() function creates a node with the name
20 and PICL class specified by name and classname respectively. It then
21 adds the node as a a child to the node specified by parh. The handle of
22 the new node is returned in nodeh.
23
25 Upon successful completion, 0 is returned. On failure, a non-negative
26 integer is returned to indicate an error.
27
28
29 PICL_STALEHANDLE is returned if the handle is no longer valid. This
30 occurs if the PICL tree was refreshed or reinitialized.
31
32
33 PICL_INVALIDHANDLE is returned if the specified handle never existed.
34
36 PICL_INVALIDARG Invalid argument
37
38
39 PICL_VALUETOOBIG Value exceeds maximum size
40
41
42 PICL_NOTSUPPORTED Property version not supported
43
44
45 PICL_CANTDESTROY Attempting to destroy before delete
46
47
48 PICL_NOTNODE Not a node
49
50
51 PICL_INVALIDHANDLE Invalid handle
52
53
54 PICL_STALEHANDLE Stale handle
55
56
57 PICL_FAILURE General system failure
58
59
61 See attributes(5) for descriptions of the following attributes:
62
63
64
65
66 ┌─────────────────────────────┬─────────────────────────────┐
67 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
68 ├─────────────────────────────┼─────────────────────────────┤
69 │Interface Stability │Evolving │
70 ├─────────────────────────────┼─────────────────────────────┤
71 │MT-Level │MT-Safe │
72 └─────────────────────────────┴─────────────────────────────┘
73
75 ptree_create_node(3PICLTREE), ptree_add_node(3PICLTREE), attributes(5)
76
77
78
79SunOS 5.11 1 Aug 200p0tree_create_and_add_node(3PICLTREE)