1ptree_create_and_add_nodeP(I3CPLICPLlTuRgE-EI)n LibrarpytrFeuen_cctrieoantse_and_add_node(3PICLTREE)
2
3
4

NAME

6       ptree_create_and_add_node - create and add node to tree and return node
7       handle
8

SYNOPSIS

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

DESCRIPTION

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

RETURN VALUES

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

ERRORS

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

ATTRIBUTES

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

SEE ALSO

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)
Impressum