join(3tcl)

💖 join — bestie edition 💖

okay so this is the join page from the Tcl Built-In Commands manual, and honestly? it's a little icon. it takes a list and smushes it into one string. that's it. that's the whole vibe. ✨

---

🌸 NAME 🌸

join — make a string by gluing list elements together 🫶

---

✨ SYNOPSIS ✨

join list ?joinString?

---

💅 DESCRIPTION 💅

so the list argument has to be a valid Tcl list — no cap, that's non-negotiable, it will simply not work otherwise 💀

this command hands you back a string, and that string is made by joining all of the elements of list together, with joinString sitting between each adjacent pair of elements. like a little friendship bracelet where the string is the beads and the glue is the... okay the metaphor fell apart but you get me 🎀

and the joinString argument? it defaults to a space character. so if you don't pass one, space is what you get. periodt. ⭐

---

🦋 EXAMPLES 🦋

making a comma-separated list — the classic, the moment, the slay:

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

using join to flatten a list by a single level — not me flattening my whole life 🙈:

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

---

🔥 SEE ALSO 🔥

• list(3tcl) — the list girlies, we love her
• lappend(3tcl) — append era
• split(3tcl) — join's chaotic opposite, she takes strings APART 💅

---

👑 KEYWORDS 👑

element, join, list, separator

---

this page is brought to you by Tcl, and yes bestie, it lives at join(3tcl) in the Tcl Built-In Commands manual — go off, you're gonna use this constantly 🌈💜