append(n)

🌸 NAME 🌸

append — appending to a variable, bestie, it's literally what it does 💅

---

✨ SYNOPSIS ✨

append varName ?value value value ...?

---

💖 DESCRIPTION 💖

Okay so here's the tea, gorgeous: append takes all of those value arguments and tacks them onto the current value of the variable called varName. That's it. That's the whole vibe. 🎀

And if varName doesn't exist yet? No worries, no cap — it just gets created, and its brand-new value is the concatenation of all the value arguments. Instant main character energy. ✨

Now, plot twist for the array girlies: if varName points at an element that doesn't exist, of an array that has a default value set, then the concatenation of that default value and all the value arguments is what gets stored in the array element. Slay. 🦋

The result of this command — like, what it actually hands back to you — is the new value that got stored in the variable varName. So you always know what you're working with. 💜

Real talk though, why is this iconic? Because it's the efficient way to build up long variables incrementally. The way that append a $b is so much more efficient than set a $a$b when $a is long… it's giving optimized. 🔥

---

🌈 EXAMPLE 🌈

Building a string of comma-separated numbers piecemeal using a loop, because sometimes you gotta assemble the fit one accessory at a time:

set var 0
for {set i 1} {$i<=10} {incr i} {
    append var "," $i
}
puts $var
# Prints 0,1,2,3,4,5,6,7,8,9,10

Look at that output. 0,1,2,3,4,5,6,7,8,9,10. Ate. 😭💖

---

👑 SEE ALSO 👑

• concat(n)
• lappend(n)

---

🍓 KEYWORDS 🍓

append, variable

---

okay bestie, that's the whole page — go forth and concatenate responsibly 🫶✨

this little love letter to append(n) comes to you straight from the Tcl built-in commands, manual page append(n) — written with so much affection, and honestly it's giving timeless because it's still exactly this good 💅🧚