Go to main content

man pages section 3: Extended Library Functions, Volume 3

Exit Print View

Updated: Thursday, June 13, 2019
 
 

ptree_create_and_add_node(3PICLTREE)

Name

ptree_create_and_add_node - create and add node to tree and return node handle

Synopsis

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

int ptree_create_and_add_node(picl_nodehdl_t parh,
     const char *name, const char *classname,
     picl_nodehdl_t *nodeh);

Description

The ptree_create_and_add_node() function creates a node with the name and PICL class specified by name and classname respectively. It then adds the node as a a child to the node specified by parh. The handle of the new node is returned in nodeh.

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_INVALIDARG

Invalid argument

PICL_VALUETOOBIG

Value exceeds maximum size

PICL_NOTSUPPORTED

Property version not supported

PICL_CANTDESTROY

Attempting to destroy before delete

PICL_NOTNODE

Not a node

PICL_INVALIDHANDLE

Invalid handle

PICL_STALEHANDLE

Stale handle

PICL_FAILURE

General system failure

Attributes

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

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
MT-Level
MT-Safe

See Also

ptree_add_node(3PICLTREE), ptree_create_node(3PICLTREE), attributes(7)