Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

blt_treeexists(3) [debian man page]

Blt_TreeExists(3)					      BLT Library Procedures						 Blt_TreeExists(3)

__________________________________________________________________________________________________________________________________________________

NAME
Blt_TreeExists - Indicates if a tree exists. SYNOPSIS
#include <bltTree.h> int Blt_TreeExists(interp, name) ARGUMENTS
Tcl_Interp *interp (in) Interpreter to determine current namespace context. const char *name (in) Name of an existing tree data object. Can be qualified by a namespace. _________________________________________________________________ DESCRIPTION
This procedure determines if a C-based tree data object exists by a given name. The arguments are as follows: interp Used the determine the current namespace context. name Name of an existing tree data object. Name can be qualified by a namespace such as fred::myTree. If no namespace qualifier is used, the current namespace is searched, then the global namespace. RETURNS
A boolean result is returned. If the tree exists 1 is returned, 0 otherwise. EXAMPLE
The following example checks if a tree "myTree" exists. if (!Blt_TreeExists(interp, "myTree")) { fprintf(stderr, "can't find tree "myTree\n"); } KEYWORDS
tree, token Tcl_TreeCreate, Tcl_TreeGetToken, Tcl_TreeReleaseToken BLT
2.4 Blt_TreeExists(3)

Check Out this Related Man Page

Blt_TreeGetToken(3)					      BLT Library Procedures					       Blt_TreeGetToken(3)

__________________________________________________________________________________________________________________________________________________

NAME
Blt_TreeGetToken - Grabs a token associated with existing tree data object. SYNOPSIS
#include <bltTree.h> int Blt_TreeGetToken(interp, name, tokenPtr) ARGUMENTS
Tcl_Interp *interp (in) Interpreter to report results back to. const char *name (in) Name of an existing tree data object. Can be qualified by a namespace. Blt_Tree *tokenPtr (out) Points to location to store the client tree token. _________________________________________________________________ DESCRIPTION
This procedure obtains a token to a C-based tree data object. The arguments are as follows: interp Interpreter to report results back to. If an error occurs, then interp->result will contain an error message. name Name of an existing tree data object. It's an error if a tree name doesn't already exist. Name can be qualified by a namespace such as fred::myTree. If no namespace qualifier is used, the tree the current namespace is searched, then the global namespace. tokenPtr Points to the location where the returned token is stored. A tree token is used to work with the tree object. A token for the tree data object is returned. Tree data objects can be shared. For example, the tree and hiertable commands may be accessing the same tree data object. Each client grabs a token that is associated with the tree. When all tokens are released (see Blt_TreeReleaseToken) the tree data object is automatically destroyed. RETURNS
A standard Tcl result is returned. If TCL_ERROR is returned, then interp->result will contain an error message. The following errors may occur: o No tree exists as name. You can use Tcl_TreeExists to determine if a tree exists beforehand. o Memory can't be allocated for the token. EXAMPLE
The following example allocated a token for an existing tree. Blt_Tree token; if (Blt_TreeGetToken(interp, "myTree", &token) != TCL_OK) { return TCL_ERROR; } printf("tree is %s ", Blt_TreeName(token)); SEE ALSO
Tcl_TreeCreate, Tcl_TreeExists, Tcl_TreeReleaseToken BLT
2.4 Blt_TreeGetToken(3)
Man Page