---
name: "Tcl_Concat"
section: "3"
platform: "linux"
package: "tcl"
version: "8.6.16-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Tcl_Concat"
---

# Tcl\_Concat(3)

concatenate a collection of strings

```

```

## NAME

Tcl\_Concat - concatenate a collection of strings

## SYNOPSIS

```
#include <tcl.h>

const char *
Tcl_Concat(argc, argv)
```

## ARGUMENTS

- int *argc* (in)

  Number of strings.

- const char \*const *argv\[\]* (in)

  Array of strings to concatenate.  Must have *argc* entries.

  ```

  ```

## DESCRIPTION

**Tcl\_Concat** is a utility procedure used by several of the Tcl commands.  Given a collection of strings, it concatenates them together into a single string, with the original strings separated by spaces.  This procedure behaves differently than **Tcl\_Merge**, in that the arguments are simply concatenated: no effort is made to ensure proper list structure. However, in most common usage the arguments will all be proper lists themselves;  if this is true, then the result will also have proper list structure.

**Tcl\_Concat** eliminates leading and trailing white space as it copies strings from **argv** to the result.  If an element of **argv** consists of nothing but white space, then that string is ignored entirely.  This white-space removal was added to make the output of the **concat** command cleaner-looking.

The result string is dynamically allocated using **Tcl\_Alloc**;  the caller must eventually release the space by calling **Tcl\_Free**.

## SEE ALSO

Tcl\_ConcatObj

## KEYWORDS

concatenate, strings