Content-type: text/html Man page of ptree_add_prop

ptree_add_prop

Section: PICL Plug-In Library Functions (3PICLTREE)
Updated: 25 Apr 2002
Index Return to Main Contents
 

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 TYPEATTRIBUTE VALUE
Interface StabilityEvolving
MT-LevelMT-Safe

 

SEE ALSO

ptree_create_prop(3PICLTREE), attributes(5)


 

Index

NAME
SYNOPSIS
DESCRIPTION
RETURN VALUES
ERRORS
ATTRIBUTES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:39:12 GMT, October 02, 2010