Content-type: text/html Man page of ptree_create_and_add_node

ptree_create_and_add_node

Section: PICL Plug-In Library Functions (3PICLTREE)
Updated: 1 Aug 2000
Index Return to Main Contents
 

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(5) for descriptions of the following attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
Interface StabilityEvolving
MT-LevelMT-Safe

 

SEE ALSO

ptree_create_node(3PICLTREE), ptree_add_node(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