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