list(n)

✨ list(n) — the Tcl built-in that makes lists ✨

okay bestie, welcome to list, one of the Tcl Built-In Commands, and honestly? she's a baddie. 💅

---

🎀 NAME 🎀

list — Create a list 💖

---

🦋 SYNOPSIS 🦋

list ?arg arg ...?

---

🌸 DESCRIPTION 🌸

So like, here's the tea 🍓: this command returns a list made up of all the args, or — and this is important — an empty string if you don't give it any args at all. No args? No list content. Periodt.

Now, the ✨magic✨ part: braces and backslashes get added as necessary, so that:

• the lindex command can be used on the result to re-extract the original arguments 👑
• eval can also be used to execute the resulting list, with arg1 comprising the command's name and the other args comprising its arguments 🔥

not me being obsessed with how much heavy lifting those auto-added braces do 😭

And here's the plot twist, because people always ask: list produces slightly different results than concat. Why? Because concat removes one level of grouping before forming the list, while list works directly from the original arguments. Same vibe, different behavior. iykyk 💀

---

🌈 EXAMPLE 🌈

okay so watch this. the command:

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

will return:

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

meanwhile concat with the same exact arguments will return:

a b c d e f {g h}

see?? the grouping level just poof gone. concat ate that one layer and left no crumbs 🫶

---

💜 SEE ALSO 💜

your girl does not work alone, she's got a whole friend group 🧚:

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

---

⭐ KEYWORDS ⭐

• element
• list
• quoting

---

and that's the whole page bestie!! 🎀 this one came from the Tcl manual, page list(n) — sending you the biggest 💖 and reminding you that this whole vibe check was brought to you by Tcl. slay, go make some lists, and remember: braces are added as necessary, no cap 🦋✨