exit(3tcl)

✨ exit — end the application, bestie ✨

okay so this is from the Tcl Built-In Commands manual, section 3tcl, and it's literally the "bye girl" button of the whole process. 🎀

---

🌸 NAME 🌸

exit — end the application 💅

---

✨ SYNOPSIS ✨

exit ?returnCode?

---

💖 DESCRIPTION 💖

So here's the tea: exit terminates the process. Like, the whole thing. Gone. Done. It hands returnCode back to the system as the exit status, which is how the outside world finds out how things went. 🦋

And if you don't give it a returnCode? It just defaults to 0. Easy. Chill. No drama. ✨

---

🎀 EXAMPLE 🎀

ngl this is the important part. Because non-zero exit codes are usually read by the calling process as "something went wrong," the exit command is lowkey a whole big deal — it's how you signal that something fatal has gone down. 😭

This code fragment is useful in scripts to act as a general problem trap:

proc main {} {
    # ... put the real main code in here ...
}

if {[catch {main} msg options]} {
    puts stderr "unexpected script error: $msg"
    if {[info exists env(DEBUG)]} {
        puts stderr "---- BEGIN TRACE ----"
        puts stderr [dict get $options -errorinfo]
        puts stderr "---- END TRACE ----"
    }

    # Reserve code 1 for "expected" error exits...
    exit 2
}

see how it reserves code 1 for "expected" error exits and busts out exit 2 for the truly unexpected chaos? iconic behavior, fr fr 👑

---

🫶 SEE ALSO 🫶

• exec(3tcl)

---

💜 KEYWORDS 💜

• abort
• exit
• process

---

reminder bestie: exit ends the whole process, not just your script. there is no coming back from this one. no cap. 💀

---

mwah 💋 that's the whole page, sourced straight from the Tcl exit(3tcl) manual — Tcl version, exit(3tcl), that's the one. 🌈⭐🍓🧚