PICL Plug-In Library Functions      ptreecreatetable(3PICLTRE)



NAME
     ptreecreatetable, ptreeaddrowtotable - create a  table
     object

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

     int ptreecreatetable(piclprophdlt *tblhdl);


     int ptreeaddrowtotable(piclprophdlt tblhdl, int nprops,
          piclprophdlt *proph);


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


     The ptreeaddrowtotable() function adds a row of  proper-
     ties  to  the table specified by tblhdl. 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.


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


     PICLNOTPROP          Not a property


     PICLNOTABLE         Not a table





SunOS 5.11          Last change: 28 Mar 2000                    1






PICL Plug-In Library Functions      ptreecreatetable(3PICLTRE)



     PICLINVALIDHANDLE    Invalid handle


     PICLSTALEHANDLE      Stale handle


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





























SunOS 5.11          Last change: 28 Mar 2000                    2