time(n)

✨ time(n) — the Tcl Built-In Commands era ✨

okay bestie, welcome to the time page of the Tcl Built-In Commands manual 💖 this is literally the stopwatch of your Tcl dreams and she is so useful, no cap.

---

🌸 NAME 🌸

time — time the execution of a script ⏱️✨

---

🎀 SYNOPSIS 🎀

time script ?count?

that's it. that's the whole vibe. 🫶

---

💅 DESCRIPTION 💅

okay so here's the tea 🍓: this command calls the Tcl interpreter count times to evaluate script — or just once if count isn't specified. and then?? it hands you back a string that looks exactly like this:

503.2 microseconds per iteration

which is telling you the average amount of time required per iteration, measured in microseconds. iconic, honestly. 👑

and listen — the time is measured in elapsed time, not CPU time. so it's the real wall-clock girlie, the whole "how long did this actually take in the real world" situation, not the "how much brainpower did the CPU use" situation. big difference, iykyk 💀

---

🌈 EXAMPLE 🌈

say you wanna estimate how long it takes for a simple Tcl for loop to count to a thousand? say less:

time {
    for {set i 0} {$i<1000} {incr i} {
        # empty body
    }
}

look at that empty body doing absolutely nothing and still getting timed. main character energy fr fr. 💖

---

🦋 SEE ALSO 🦋

• clock(n) — go give her a visit too, she's lovely

---

⭐ KEYWORDS ⭐

• script
• time

---

🫶 friendly reminder bestie: count is optional, but if you pass it, your script is running that many times. don't be out here timing a script a million times and then being shocked it took a while. 😭

and that's the whole page!! sending you off with love from the Tcl crew, this was time(n) — mwah, go time something cute 💅✨🌸