PTREE_ADD_PROP(3PICLTREE) PICL Plug-In Library Functions

NAME

ptree_add_prop, ptree_delete_prop - add or delete a property

SYNOPSIS

cc [ flag... ] file... -lpicltree [ library... ]
#include <picltree.h>

int ptree_add_prop(picl_nodehdl_t nodeh, picl_prophdl_t proph);


int ptree_delete_prop(picl_prophdl_t proph);

DESCRIPTION

The ptree_add_prop() function adds the property specified by the
handle proph to the list of properties of the node specified by
handle nodeh.


The ptree_delete_prop() function deletes the property from the
property list of the node. For a table property, the entire table is
deleted.

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


PICL_INVALIDHANDLE is returned if the specified handle never existed.

ERRORS

PICL_NOTTABLE
Not a table


PICL_NOTPROP
Not a property


PICL_INVALIDHANDLE
Invalid handle


PICL_STALEHANDLE
Stale handle


PICL_PROPEXISTS
Property already exists


PICL_FAILURE
General system failure

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Evolving |
+--------------------+-----------------+
|MT-Level | MT-Safe |
+--------------------+-----------------+

SEE ALSO

ptree_create_prop(3PICLTREE), attributes(7)

April 25, 2002 PTREE_ADD_PROP(3PICLTREE)