Manual Pages for UNIX Operating System command usage for man picl_get_next_by_row

PICL Library Functions                picl_get_next_by_row(3PICL)



NAME
     picl_get_next_by_row, picl_get_next_by_col - access a  table
     property

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

     int picl_get_next_by_row(picl_prophdl_t proph,
          picl_prophdl_t *colh);


     int picl_get_next_by_col(picl_prophdl_t proph,
          picl_prophdl_t *colh);


DESCRIPTION
     The picl_get_next_by_row() 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 picl_get_next_by_col() 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 PICL_ENDOFLIST.

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


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


     PICL_INVALIDHANDLE 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.

ERRORS
     PICL_NOTINITIALIZED    Session not initialized






SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Library Functions                picl_get_next_by_row(3PICL)



     PICL_NORESPONSE        Daemon not responding


     PICL_NOTTABLE          Not a table


     PICL_INVALIDHANDLE     Invalid handle


     PICL_STALEHANDLE       Stale handle


     PICL_FAILURE           General system failure


     PICL_ENDOFLIST         General system failure


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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


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






















SunOS 5.11          Last change: 28 Mar 2000                    2