Manual Pages for UNIX Operating System command usage for man ptree_find_node

PICL Plug-In Library Functions         ptree_find_node(3PICLTREE)



NAME
     ptree_find_node - find node with given property and value

SYNOPSIS
     cc [ flag... ] file... -lpicltree [library... ]
     #include 

     int ptree_find_node(picl_nodehdl_t rooth, char *pname,
          picl_prop_type_t ptype, void *pval, size_t valsize,
          picl_nodehdl_t *retnodeh);


DESCRIPTION
     The ptree_find_node() function visits the nodes in the  sub-
     tree  under  the  node specified by rooth. The handle of the
     node that has the  property  whose  name,  type,  and  value
     matches the name, type, and value specified in pname, ptype,
     and pval respectively, is returned in the location given  by
     retnodeh.  The  argument valsize gives the size of the value
     in pval. The first valsize number of bytes of  the  property
     value is compared with pval.

RETURN VALUES
     Upon successful completion, 0 is  returned.  On  failure,  a
     non-negative integer is returned to indicate an error.


     PICL_NODENOTFOUND is returned  if  there  is  no  node  that
     matches the property criteria can be found.

ERRORS
     PICL_NOTNODE          Not a node


     PICL_INVALIDHANDLE    Invalid handle


     PICL_STALEHANDLE      Stale handle


     PICL_PROPNOTFOUND     Property not found


     PICL_FAILURE          General system failure


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:






SunOS 5.11           Last change: 1 Aug 2000                    1






PICL Plug-In Library Functions         ptree_find_node(3PICLTREE)



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     ptree_get_prop_by_name(3PICLTREE),
     ptree_get_propinfo(3PICLTREE), ptree_get_propval(3PICLTREE),
     ptree_get_propval_by_name(3PICLTREE), attributes(5)










































SunOS 5.11           Last change: 1 Aug 2000                    2