rename(n)

💖 rename(n) — the Tcl Built-In Commands glow-up 💖

okay bestie, welcome to rename(n), straight out of the Tcl Built-In Commands lineup, and honestly? she's a tiny little icon. one job, does it flawlessly. let's get into it ✨

---

🌸 NAME 🌸

rename — Rename or delete a command 🎀

---

✨ SYNOPSIS ✨

rename oldName newName

that's it. two args. no drama. periodt 💅

---

🦋 DESCRIPTION 🦋

so here's the tea ☕: rename takes the command that used to be called oldName and renames it so that it's now called newName. glow-up complete, no cap.

and if newName is an empty string, then oldName gets deleted. gone. ghosted. it's giving "we don't talk anymore" 😭💀

now, both oldName and newName are allowed to include namespace qualifiers (aka the names of the containing namespaces). and here's the part you gotta remember, fr fr: if a command gets renamed into a different namespace, then every future invocation of it will execute in that new namespace. she moves houses, she lives there now. main character relocation energy 👑

and the result? rename returns an empty string as its result. that's it. nothing. silence. elegant. 🫶

---

🎀 EXAMPLE 🎀

okay so this is actually so smart — you can use rename to wrap the standard Tcl commands with your own monitoring machinery. like, imagine you wanna count how many times the source command gets called. obsessed. here's how:

rename ::source ::theRealSource
set sourceCount 0
proc ::source args {
    global sourceCount
    puts "called source for the [incr sourceCount]'th time"
    uplevel 1 ::theRealSource $args
}

see what she did?? she renamed the real one out of the way, then slid her own ::source in to do the counting, and called the original with uplevel. genius behavior honestly 🌈✨

---

🌈 SEE ALSO 🌈

• namespace(n)
• proc(n)

go read those too, bestie, they're the friend group 💖

---

⭐ KEYWORDS ⭐

command, delete, namespace, rename

iykyk 🧚

---

and that's the whole page, bestie!! this one came to you from Tcl — yep, the rename(n) page itself, Tcl Built-In Commands energy through and through 🎀💜 thanks for reading, mwah, slay, bye!! 🦋🌸💅