Manual Pages for UNIX Operating System command usage for man ptree_create_table

PICL Plug-In Library Functions      ptree_create_table(3PICLTREE)



NAME
     ptree_create_table, ptree_add_row_to_table - create a  table
     object

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

     int ptree_create_table(picl_prophdl_t *tbl_hdl);


     int ptree_add_row_to_table(picl_prophdl_t tbl_hdl, int nprops,
          picl_prophdl_t *proph);


DESCRIPTION
     The ptree_create_table() function creates a table object and
     returns the handle of the table in tbl_hdl.


     The ptree_add_row_to_table() function adds a row of  proper-
     ties  to  the table specified by tbl_hdl. The handles of the
     properties of the row are specified in the proph  array  and
     nprops  specifies  the  number  of handles in the array. The
     number of columns in the table is determined from the  first
     row added to the table. If extra column values are specified
     in subsequent rows, they are ignored. The row is appended to
     the end of the table.

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_INVALIDARG       Invalid argument


     PICL_NOTPROP          Not a property


     PICL_NOTTABLE         Not a table





SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Plug-In Library Functions      ptree_create_table(3PICLTREE)



     PICL_INVALIDHANDLE    Invalid handle


     PICL_STALEHANDLE      Stale handle


     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
     attributes(5)





























SunOS 5.11          Last change: 28 Mar 2000                    2