1ptree_find_node(3PICLTREEP)ICL Plug-In Library Functionpstree_find_node(3PICLTREE)
2
3
4

NAME

6       ptree_find_node - find node with given property and value
7

SYNOPSIS

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

DESCRIPTION

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

RETURN VALUES

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

ERRORS

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

ATTRIBUTES

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

SEE ALSO

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