ptree_delete_prop(3PICLTREE)

Name | Synopsis | Description | Return Values | Errors | Attributes | See Also

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	Evolving
MT-Level	MT-Safe

See Also

ptree_create_prop(3PICLTREE), attributes(5)

Name | Synopsis | Description | Return Values | Errors | Attributes | See Also