Blt_TreeReleaseToken - Releases token associated with tree object.
Contents
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_TreeGetTokenorBlt_TreeCreate earlier.
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
BLT 2.5 Blt_TreeReleaseToken(3)
Name
Blt_TreeReleaseToken - Releases token associated with tree object.
Returns
Nothing.
Synopsis
#include<bltTree.h>
int
Blt_TreeReleaseToken(token)
