1ptree_create_node(3PICLTRPEIEC)L Plug-In Library Functipotnrsee_create_node(3PICLTREE)
2
3
4

NAME

6       ptree_create_node, ptree_destroy_node - create or destroy a node
7

SYNOPSIS

9       cc [ flag... ] file... -lpicltree [ library... ]
10       #include <picltree.h>
11
12       int ptree_create_node(char *name, char *clname,
13            picl_nodehdl_t *nodeh);
14
15
16       int ptree_destroy_node(picl_nodehdl_t nodeh);
17
18

DESCRIPTION

20       The  ptree_create_node()  function  creates  a node and sets the "name"
21       property value to the string specified in name and the "class" property
22       value  to the string specified in clname. The handle of the new node is
23       copied into the location given by nodeh.
24
25
26       The ptree_destroy_node() function destroys the node specified by  nodeh
27       and  frees  up  any allocated space. The node to be destroyed must have
28       been     previously     deleted     by      ptree_delete_node      (see
29       ptree_add_node(3PICLTREE)). Otherwise, PICL_CANTDESTROY is returned.
30

RETURN VALUES

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

ERRORS

43       PICL_INVALIDARG       Invalid argument
44
45
46       PICL_VALUETOOBIG      Value exceeds maximum size
47
48
49       PICL_NOTSUPPORTED     Property version not supported
50
51
52       PICL_CANTDESTROY      Attempting to destroy before delete
53
54
55       PICL_TREEBUSY         PICL tree is busy
56
57
58       PICL_NOTNODE          Not a node
59
60
61       PICL_INVALIDHANDLE    Invalid handle
62
63
64       PICL_STALEHANDLE      Stale handle
65
66
67       PICL_FAILURE          General system failure
68
69

ATTRIBUTES

71       See attributes(5) for descriptions of the following attributes:
72
73
74
75
76       ┌─────────────────────────────┬─────────────────────────────┐
77       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
78       ├─────────────────────────────┼─────────────────────────────┤
79       │Interface Stability          │Evolving                     │
80       ├─────────────────────────────┼─────────────────────────────┤
81       │MT-Level                     │MT-Safe                      │
82       └─────────────────────────────┴─────────────────────────────┘
83

SEE ALSO

85       ptree_add_node(3PICLTREE), attributes(5)
86
87
88
89SunOS 5.11                        28 Mar 2000     ptree_create_node(3PICLTREE)
Impressum