Blt_TreeReleaseToken(3)
NAME
Blt_TreeReleaseToken - Releases token associated with tree object.
SYNOPSIS
#include <bltTree.h> int Blt_TreeReleaseToken(token)
ARGUMENTS
- Blt_Tree *token (in) Token of tree to be released.
- _________________________________________________________________
DESCRIPTION
This procedure releases the token associated with a C-based tree data
object. When all outstanding tokens for a tree data object have been
released, then the data object itself will be freed. The arguments are
as follows:
- token Token of the tree data object to be released. This token was
- initialized either by Tcl_TreeGetToken or Blt_TreeCreate earlier.
RETURNS
Nothing.
EXAMPLE
- The following example creates and then releases a new token.
- Blt_Tree token;
- if (Blt_TreeCreate(interp, "myTree", &token) != TCL_OK) {
return TCL_ERROR;
- }
printf("tree is %s\n", Blt_TreeName(token)); - /* Tree will be destroyed when the token is released. */
Blt_TreeReleaseToken(token);
KEYWORDS
- tree, token