1ptree_get_first_prop(3PICPLITCRLEEP)lug-In Library Funpcttrieoen_sget_first_prop(3PICLTREE)
2
3
4

NAME

6       ptree_get_first_prop,  ptree_get_next_prop  -  get a property handle of
7       the node
8

SYNOPSIS

10       cc [ flag... ] file... -lpicltree [ library... ]
11       #include <picltree.h>
12
13       int ptree_get_first_prop(picl_nodehdl_t nodeh,
14            picl_prophdl_t *proph);
15
16
17       int ptree_get_next_prop(picl_prophdl_t proph,
18            picl_prophdl_t *nextproph);
19
20

DESCRIPTION

22       The ptree_get_first_prop() function gets the handle of the first  prop‐
23       erty  of  the  node  specified by nodeh and copies it into the location
24       specified by proph.
25
26
27       The ptree_get_next_prop() function gets the handle of the next property
28       after  the  one  specified  by proph from the list of properties of the
29       node and copies it into the location specified by nextproph.
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_NOTPROP          Not a property
44
45
46       PICL_NOTNODE          Not a node
47
48
49       PICL_ENDOFLIST        End of list
50
51
52       PICL_INVALIDHANDLE    Invalid handle
53
54
55       PICL_STALEHANDLE      Stale handle
56
57
58       PICL_FAILURE          General system failure
59
60

ATTRIBUTES

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

SEE ALSO

76       ptree_get_prop_by_name(3PICLTREE), attributes(5)
77
78
79
80SunOS 5.11                        28 Mar 2000  ptree_get_first_prop(3PICLTREE)
Impressum