---
name: "Blt_TreeReleaseToken"
section: "3"
platform: "linux"
package: "blt-dev"
version: "2.5.3+dfsg-8"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Blt_TreeReleaseToken"
---

# Blt\_TreeReleaseToken(3)

Releases token associated with tree object.

```

```

## 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