Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 ob-
     ject.  When all outstanding tokens for a tree data  object  have  been  re-
     leased,  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

BLT				       2.5		 Blt_TreeReleaseToken(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Blt_TreeReleaseToken&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help