1ptree_find_node(3PICLTREEP)ICL Plug-In Library Functionpstree_find_node(3PICLTREE)
2
3
4
6 ptree_find_node - find node with given property and value
7
9 cc [ flag... ] file... -lpicltree [library... ]
10 #include <picltree.h>
11
12 int ptree_find_node(picl_nodehdl_t rooth, char *pname,
13 picl_prop_type_t ptype, void *pval, size_t valsize,
14 picl_nodehdl_t *retnodeh);
15
16
18 The ptree_find_node() function visits the nodes in the subtree under
19 the node specified by rooth. The handle of the node that has the prop‐
20 erty whose name, type, and value matches the name, type, and value
21 specified in pname, ptype, and pval respectively, is returned in the
22 location given by retnodeh. The argument valsize gives the size of the
23 value in pval. The first valsize number of bytes of the property value
24 is compared with pval.
25
27 Upon successful completion, 0 is returned. On failure, a non-negative
28 integer is returned to indicate an error.
29
30
31 PICL_NODENOTFOUND is returned if there is no node that matches the
32 property criteria can be found.
33
35 PICL_NOTNODE Not a node
36
37
38 PICL_INVALIDHANDLE Invalid handle
39
40
41 PICL_STALEHANDLE Stale handle
42
43
44 PICL_PROPNOTFOUND Property not found
45
46
47 PICL_FAILURE General system failure
48
49
51 See attributes(5) for descriptions of the following attributes:
52
53
54
55
56 ┌─────────────────────────────┬─────────────────────────────┐
57 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
58 ├─────────────────────────────┼─────────────────────────────┤
59 │Interface Stability │Evolving │
60 ├─────────────────────────────┼─────────────────────────────┤
61 │MT-Level │MT-Safe │
62 └─────────────────────────────┴─────────────────────────────┘
63
65 ptree_get_prop_by_name(3PICLTREE), ptree_get_propinfo(3PICLTREE),
66 ptree_get_propval(3PICLTREE), ptree_get_propval_by_name(3PICLTREE),
67 attributes(5)
68
69
70
71SunOS 5.11 1 Aug 2000 ptree_find_node(3PICLTREE)