Manual Pages for UNIX Operating System command usage for man ptree_get_next_by_row

PICL Plug-In Library Functions   ptree_get_next_by_row(3PICLTREE)



NAME
     ptree_get_next_by_row,  ptree_get_next_by_col  -  access   a
     table property

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

     int ptree_get_next_by_row(picl_prophdl_t proph,
          picl_prophdl_t *rowh);


     int ptree_get_next_by_col(picl_prophdl_t proph,
          picl_prophdl_t *colh);


DESCRIPTION
     The ptree_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 ptree_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.

ERRORS
     PICL_NOTTABLE         Not a table


     PICL_INVALIDHANDLE    Invalid handle





SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Plug-In Library Functions   ptree_get_next_by_row(3PICLTREE)



     PICL_STALEHANDLE      Stale handle


     PICL_ENDOFLIST        End of list


     PICL_FAILURE          General system failure


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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | MT-Safe                     |
    |_____________________________|_____________________________|


SEE ALSO
     ptree_create_table(3PICLTREE), attributes(5)





























SunOS 5.11          Last change: 28 Mar 2000                    2