PICL Plug-In Library Functions         ptreefindnode(3PICLTRE)



NAME
     ptreefindnode - find node with given property and value

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

     int ptreefindnode(piclnodehdlt rooth, char *pname,
          piclproptypet ptype, void *pval, sizet valsize,
          piclnodehdlt *retnodeh);


DESCRIPTION
     The ptreefindnode() 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.


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

ERORS
     PICLNOTNODE          Not a node


     PICLINVALIDHANDLE    Invalid handle


     PICLSTALEHANDLE      Stale handle


     PICLPROPNOTFOUND     Property not found


     PICLFAILURE          General system failure


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






SunOS 5.11           Last change: 1 Aug 2000                    1






PICL Plug-In Library Functions         ptreefindnode(3PICLTRE)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     ptreegetpropbyname(3PICLTRE),
     ptreegetpropinfo(3PICLTRE), ptreegetpropval(3PICLTRE),
     ptreegetpropvalbyname(3PICLTRE), attributes(5)










































SunOS 5.11           Last change: 1 Aug 2000                    2