PICL Library Functions                      piclfindnode(3PICL)



NAME
     piclfindnode - find node with given property and value

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

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


DESCRIPTION
     The piclfindnode() 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  valsize  argument  specifies the size of the
     value in pval. The first valsize number of bytes of the pro-
     perty value is compared with pval.

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


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

ERORS
     PICLFAILURE          General system failure


     PICLINVALIDHANDLE    Invalid handle


     PICLNODENOTFOUND     Node not found


     PICLNOTNODE          Not a node


     PICLSTALEHANDLE      Stale handle


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






SunOS 5.11           Last change: 5 Feb 2004                    1






PICL Library Functions                      piclfindnode(3PICL)



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


SEE ALSO
     piclgetpropinfo(3PICL),           piclgetpropval(3PICL),
     piclgetpropvalbyname(3PICL),
     piclgetpropbyname(3PICL), attributes(5)










































SunOS 5.11           Last change: 5 Feb 2004                    2