join(n) Tcl Built-In Commands join(n)

```

```

# [NAME](#NAME)

join - Create a string by joining together list elements

# [SYNOPSIS](#SYNOPSIS)

**join list** ?*joinString*?

```

```

# [DESCRIPTION](#DESCRIPTION)

The *list* argument must be a valid Tcl list. This command returns the string formed by joining all of the elements of *list* together with *joinString* separating each adjacent pair of elements. The *joinString* argument defaults to a space character.

# [EXAMPLES](#EXAMPLES)

Making a comma-separated list:

```
set data {1 2 3 4 5}
join $data ", "


     → 1, 2, 3, 4, 5
```

Using **join** to flatten a list by a single level:

```
set data {1 {2 3} 4 {5 {6 7} 8}}
join $data


     → 1 2 3 4 5 {6 7} 8
```

# [SEE ALSO](#SEE_ALSO)

[list(n)](/man/os/tcl/list.n), [lappend(n)](/man/os/tcl/lappend.n), [split(n)](/man/os/tcl/split.n)

# [KEYWORDS](#KEYWORDS)

element, join, list, separator

Tcl

---

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