PICL Library Functions                piclgetnextbyrow(3PICL)



NAME
     piclgetnextbyrow, piclgetnextbycol - access a  table
     property

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

     int piclgetnextbyrow(piclprophdlt proph,
          piclprophdlt *colh);


     int piclgetnextbycol(piclprophdlt proph,
          piclprophdlt *colh);


DESCRIPTION
     The piclgetnextbyrow() 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 piclgetnextbycol() 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.   This error may be returned for a previously valid
     handle if the daemon was brought down  and  restarted.  When
     this occurs a client must revalidate any saved handles.

ERORS
     PICLNOTINITIALIZED    Session not initialized






SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Library Functions                piclgetnextbyrow(3PICL)



     PICLNORESPONSE        Daemon not responding


     PICLNOTABLE          Not a table


     PICLINVALIDHANDLE     Invalid handle


     PICLSTALEHANDLE       Stale handle


     PICLFAILURE           General system failure


     PICLENDOFLIST         General system failure


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     piclgetpropval(3PICL), attributes(5)






















SunOS 5.11          Last change: 28 Mar 2000                    2