join(n)

joinn

Create a string by joining together list elements

Usage

join list ?joinString?


    


    


    

Overview

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

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

Keywords

element, join, list, separator

From tcl 8.6.16-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.