Tcl\_Concat(3) Tcl Library Procedures Tcl\_Concat(3)

```

```

# [NAME](#NAME)

Tcl\_Concat - concatenate a collection of strings

# [SYNOPSIS](#SYNOPSIS)

```
#include <tcl.h>

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

# [ARGUMENTS](#ARGUMENTS)

Tcl\_Size *argc* (in)

Number of strings.

const char \*const *\*argv* (in)

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

```
    
```

# [DESCRIPTION](#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](#SEE_ALSO)

Tcl\_ConcatObj

# [KEYWORDS](#KEYWORDS)

concatenate, strings

7.5 Tcl

---

Document: Tcl_Concat(3) from tcl 9.1.0-r2 (Chainguard OS)
Source: https://downloads.sourceforge.net/project/tcl/Tcl/9.1.0/tcl9.1.0-src.tar.gz