1ptree_get_prop_by_name(3PPIICCLLTRPElEu)g-In Library Fputnrcetei_ognest_prop_by_name(3PICLTREE)
2
3
4

NAME

6       ptree_get_prop_by_name - get a property handle by name
7

SYNOPSIS

9       cc [ flag ] file... -lpicltree [ library... ]
10       #include <picltree.h>
11
12       int ptree_get_prop_by_name(picl_nodehdl_t nodeh, char *name,
13            picl_prophdl_t *proph);
14
15

DESCRIPTION

17       The  ptree_get_prop_by_name() function gets the handle of the property,
18       whose name is specified in name, of the node specified  by  the  handle
19       nodeh.   The  property  handle is copied into the location specified by
20       proph.
21

RETURN VALUES

23       Upon successful completion, 0 is returned. On failure,  a  non-negative
24       integer is returned to indicate an error.
25
26
27       PICL_RESERVEDNAME  is returned if the name specified is a PICL reserved
28       name property. Reserved name properties do not have an associated prop‐
29       erty  handle. Use ptree_get_propval_by_name(3PICLTREE) to get the value
30       of a reserved property.
31
32
33       PICL_STALEHANDLE is returned if the handle is  no  longer  valid.  This
34       occurs if the PICL tree was refreshed or reinitialized.
35
36
37       PICL_INVALIDHANDLE is returned if the specified handle never existed.
38

ERRORS

40       PICL_NOTNODE          Not a node
41
42
43       PICL_RESERVEDNAME     Property name is reserved
44
45
46       PICL_INVALIDHANDLE    Invalid handle
47
48
49       PICL_STALEHANDLE      Stale handle
50
51
52       PICL_PROPNOTFOUND     Property not found
53
54
55       PICL_FAILURE          General system failure
56
57

ATTRIBUTES

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

SEE ALSO

73       ptree_get_first_prop(3PICLTREE),  ptree_get_propval_by_name(3PICLTREE),
74       attributes(5)
75
76
77
78SunOS 5.11                        28 Mar 2000ptree_get_prop_by_name(3PICLTREE)
Impressum