Scroll to navigation

Blt_TreeReleaseToken(3) BLT Library Procedures 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 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







  

    2.5
    BLT