1ptree_create_table(3PICLTPRIECEL)Plug-In Library Functpitornese_create_table(3PICLTREE)
2
3
4

NAME

6       ptree_create_table, ptree_add_row_to_table - create a table object
7

SYNOPSIS

9       cc [ flag... ] file... -lpicltree [ library... ]
10       #include <picltree.h>
11
12       int ptree_create_table(picl_prophdl_t *tbl_hdl);
13
14
15       int ptree_add_row_to_table(picl_prophdl_t tbl_hdl, int nprops,
16            picl_prophdl_t *proph);
17
18

DESCRIPTION

20       The  ptree_create_table()  function  creates a table object and returns
21       the handle of the table in tbl_hdl.
22
23
24       The ptree_add_row_to_table() function adds a row of properties  to  the
25       table  specified  by  tbl_hdl. The handles of the properties of the row
26       are specified in the proph array and nprops  specifies  the  number  of
27       handles  in the array. The number of columns in the table is determined
28       from the first row added to the table. If extra column values are spec‐
29       ified  in subsequent rows, they are ignored. The row is appended to the
30       end of the table.
31

RETURN VALUES

33       Upon successful completion, 0 is returned. On failure,  a  non-negative
34       integer is returned to indicate an error.
35
36
37       PICL_STALEHANDLE  is  returned  if  the handle is no longer valid. This
38       occurs if the PICL tree was refreshed or reinitialized.
39
40
41       PICL_INVALIDHANDLE is returned if the specified handle never existed.
42

ERRORS

44       PICL_INVALIDARG       Invalid argument
45
46
47       PICL_NOTPROP          Not a property
48
49
50       PICL_NOTTABLE         Not a table
51
52
53       PICL_INVALIDHANDLE    Invalid handle
54
55
56       PICL_STALEHANDLE      Stale handle
57
58
59       PICL_FAILURE          General system failure
60
61

ATTRIBUTES

63       See attributes(5) for descriptions of the following attributes:
64
65
66
67
68       ┌─────────────────────────────┬─────────────────────────────┐
69       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
70       ├─────────────────────────────┼─────────────────────────────┤
71       │Interface Stability          │Evolving                     │
72       ├─────────────────────────────┼─────────────────────────────┤
73       │MT-Level                     │MT-Safe                      │
74       └─────────────────────────────┴─────────────────────────────┘
75

SEE ALSO

77       attributes(5)
78
79
80
81SunOS 5.11                        28 Mar 2000    ptree_create_table(3PICLTREE)
Impressum