ptree_add_prop(3PICLTREEPICL Plug-In Library Functionptree_add_prop(3PICLTREE)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(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Committed │
├─────────────────────────────┼─────────────────────────────┤
│MT-Level │MT-Safe │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOptree_create_prop(3PICLTREE), attributes(5)SunOS 5.11 25 Apr 2002 ptree_add_prop(3PICLTREE)