break(n)

💖 break(n) — Tcl Built-In Commands 💖

ok bestie, pull up a chair, we're talking about break 🎀

---

✨ NAME ✨

break — abort looping command 💅

---

✨ SYNOPSIS ✨

break

---

✨ DESCRIPTION ✨

so like. break is that girl you call when you're inside a loop and you simply cannot anymore 🫶 It's typically invoked inside the body of a looping command — think for, foreach, or while — and it does not do the thing politely. no ma'am.

Here's the tea: it returns a 3 (TCL_BREAK) result code, which causes a break exception to occur 😭 And that exception is dramatic in the best way — it causes the current script to be aborted out to the innermost containing loop command, which then aborts its execution and returns normally. like, the loop just stops. no more iterations. gone. bye. ✨

ngl the "innermost containing loop" part matters — it's the closest loop that catches the exception, not some random outer one. lowkey iconic behavior.

and it's not only loops that know how to handle break exceptions, bestie. They're also handled in a few other situations:

• the catch command 🪤
• Tk event bindings 🎛️
• the outermost scripts of procedure bodies 📜

so it's giving "handled in multiple places" energy fr fr 💜

---

✨ EXAMPLE ✨

wanna print a line for each of the integers from 0 to 5? say less 🍓

for {set x 0} {$x<10} {incr x} {
    if {$x > 5} {
        break
    }
    puts "x is $x"
}

see how the loop wants to go to 10 but break said "not today" and dipped at 5? main character energy honestly 👑

---

✨ SEE ALSO ✨

go read these too, they're all besties:

• catch(n)
• continue(n)
• for(n)
• foreach(n)
• return(n)
• while(n)

---

✨ KEYWORDS ✨

abort, break, loop 💫

---

and that's the whole page, babe 🦋 this one's straight out of the Tcl manual — page break(n), Tcl Built-In Commands, brought to you by Tcl itself 💖 no cap, that's the source, that's the version, that's the date, periodt ✨🌸