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