list(3tcl)

💖 list — the Tcl built-in manual, but make it cute 💖

okay bestie, gather round, we're talking about list from Tcl Built-In Commands and honestly? she's the moment. 🌸

---

✨ NAME ✨

list — Create a list 🎀

---

🦋 SYNOPSIS 🦋

list ?arg arg ...?

---

💅 DESCRIPTION 💅

okay so here's the tea: this command returns a list made up of all the args, or, if you pass no args at all, it hands you back an empty string. nothing. a void. a clean slate. 🫶

and here's the part that's giving genius: braces and backslashes get added in wherever they're needed, so that:

• lindex can be used on the result to re-extract the original arguments — like, it'll literally reconstruct them for you, no cap ✨
• and also so that eval can be used to execute the resulting list, with arg1 comprising the command's name and the other args comprising its arguments 🔥

now, lowkey important comparison moment: list produces slightly different results than concat. the difference? concat removes one level of grouping before forming the list, while list works directly from the original arguments. that's it, that's the whole vibe shift. 💀

---

🌈 EXAMPLE 🌈

the command

list a b "c d e  " "  f {g h}"

will return

a b {c d e  } {  f {g h}}

while concat with the same arguments will return

a b c d e f {g h}

see?? she preserved those spaces and braces. iconic behaviour. periodt. 👑

---

🧚 SEE ALSO 🧚

• lappend(3tcl)
• lassign(3tcl)
• ledit(3tcl)
• lindex(3tcl)
• linsert(3tcl)
• llength(3tcl)
• lmap(3tcl)
• lpop(3tcl)
• lrange(3tcl)
• lremove(3tcl)
• lrepeat(3tcl)
• lreplace(3tcl)
• lreverse(3tcl)
• lsearch(3tcl)
• lseq(3tcl)
• lset(3tcl)
• lsort(3tcl)

the whole list-adjacent friend group, fr fr 💜

---

🔑 KEYWORDS 🔑

element, list, quoting ⭐

---

and that's the page!! 🎀 brought to you by the Tcl crew, list(3tcl), iykyk — go forth and build your lists, bestie, you're gonna slay 💖🦋✨