PICL Plug-In Library Functions
                              ptreewalktreebyclass(3PICLTRE)



NAME
     ptreewalktreebyclass - walk subtree by class

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

     int ptreewalktreebyclass(piclnodehdlt rooth,
          const char *classname, void *cargs,
          int (*callback)(piclnodehdlt nodeh, void *cargs));


DESCRIPTION
     The ptreewalktreebyclass() function visits all the nodes
     of  the  subtree under the node specified by rooth. The PICL
     class name of the visited node is compared  with  the  class
     name  specified  by classname. If the class names match, the
     callback function specified by callback is called  with  the
     matching node handle and the argument provided in cargs. If
     the class name specified in  classname  is  NUL,  then  the
     callback function is invoked for all the nodes.


     The return value from  the  callback  function  is  used  to
     determine  whether  to  continue or terminate the tree walk.
     The  callback   function   returns   PICLWALKCONTINUE   or
     PICLWALKTERMINATE to continue or terminate the tree walk.

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

ERORS
     PICLNOTNODE          Not a node


     PICLINVALIDHANDLE    Invalid handle specified


     PICLSTALEHANDLE      Stale handle specified


     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
                              ptreewalktreebyclass(3PICLTRE)




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


SEE ALSO
     ptreegetpropvalbyname(3PICLTRE), attributes(5)











































SunOS 5.11           Last change: 1 Aug 2000                    2






PICL Plug-In Library Functions
                              ptreewalktreebyclass(3PICLTRE)






















































SunOS 5.11           Last change: 1 Aug 2000                    3