PICL Plug-In Library Functions   ptreegetnextbyrow(3PICLTRE)



NAME
     ptreegetnextbyrow,  ptreegetnextbycol  -  access   a
     table property

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

     int ptreegetnextbyrow(piclprophdlt proph,
          piclprophdlt *rowh);


     int ptreegetnextbycol(piclprophdlt proph,
          piclprophdlt *colh);


DESCRIPTION
     The ptreegetnextbyrow() function copies  the  handle  of
     the  property that is in the next column of the table and on
     the same row as the property proph.  The  handle  is  copied
     into the location given by rowh.


     The ptreegetnextbycol() function copies  the  handle  of
     the property that is in the next row of the table and on the
     same column as the property proph. The handle is copied into
     the location given by colh.


     If there are no more rows or columns, this function  returns
     the value PICLENDOFLIST.

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


     PICLSTALEHANDLE is returned if  the  handle  is  no  longer
     valid.  This occurs if the PICL tree was refreshed or reini-
     tialized.


     PICLINVALIDHANDLE is returned if the specified handle never
     existed.

ERORS
     PICLNOTABLE         Not a table


     PICLINVALIDHANDLE    Invalid handle





SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Plug-In Library Functions   ptreegetnextbyrow(3PICLTRE)



     PICLSTALEHANDLE      Stale handle


     PICLENDOFLIST        End of list


     PICLFAILURE          General system failure


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



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


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





























SunOS 5.11          Last change: 28 Mar 2000                    2