Linux Certif

Toute la documentation sur la certification Linux LPI

Blt_TreeReleaseToken

---

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