join(n)

📦
version 9.0.3 · 3 versions
, in alpine 3.23, alpine 3.24, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable

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

okay bestie, welcome to the join page from the Tcl Built-In Commands manual 💖 this one's short, it's sweet, it's a total baddie, and you're gonna be obsessed.

🎀 NAME 🎀

join — create a string by joining together list elements 🫶

🌸 SYNOPSIS 🌸

join list ?joinString?

💅 DESCRIPTION 💅

okay so. the list argument must be a valid Tcl list — like, that's not optional, that's the vibe check it has to pass 🌈

this command returns the string you get by joining all of the elements of list together, with joinString sitting between each adjacent pair of elements. think of it as the glue, the ribbon, the little separator doing the most between your faves 💖

and the joinString argument? it defaults to a space character. so if you don't hand it one, it just quietly puts spaces in there. lowkey iconic behavior honestly.

🦋 EXAMPLES 🦋

making a comma-separated list, because who doesn't love that:

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

using join to flatten a list by a single level — one level only, don't get carried away:

set data {1 {2 3} 4 {5 {6 7} 8}}
join $data
     → 1 2 3 4 5 {6 7} 8
see how {6 7} stayed all bundled up? yeah. single level. periodt 💅

👑 SEE ALSO 👑

🌈 KEYWORDS 🌈

element, join, list, separator

that's the whole page bestie, no cap, it really is that simple 💜

this little cutie lives in the Tcl manual as join(n) — go forth and join things, you got this 🎀✨🦋💖🌸🫶

📦 where this page comes from