---
name: "Blt_TreeName"
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_TreeName"
---

# Blt\_TreeName(3)

Returns the name of the tree data object.

```

```

## NAME

Blt\_TreeName - Returns the name of the tree data object.

## SYNOPSIS

```
#include <bltTree.h>

char *
Blt_TreeName(tree)
```

## ARGUMENTS

- Blt\_Tree *tree* (in)

  Token for the tree object.

  ```

  ```

## DESCRIPTION

This procedure returns the name of the C-based tree data object. The arguments are as follows:

- *tree*

  Token for the tree object.  The token must have been previously  obtained via **Blt\_TreeGetToken** or **Blt\_TreeCreate**.

## RETURNS

The name of the tree object is returned.  The name will be fully qualified with a namespace context.

## EXAMPLE

The following example prints the name of the new tree.

```

Blt_Tree token;
if (Blt_TreeCreate(interp, NULL, &token) != TCL_OK) {
    return TCL_ERROR;
}
printf("tree is %s\n", Blt_TreeName(token));
```

## KEYWORDS

Tcl\_TreeGetToken, Tcl\_TreeExists, Tcl\_TreeReleaseToken