Tcl_Sleep(3tcl)

📦
version 9.0.4 · 2 versions
, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

💤 Tcl_Sleep — bestie, it's naptime (Tcl Library Procedures)

okay so real talk, you're in the Tcl_Sleep(3tcl) zone of the Tcl Library Procedures and honestly? this one is a little icon. it does one thing, it does it well, and it does it slowly. on purpose. ✨

🌸 NAME 🌸

Tcl_Sleep — delay execution for a given number of milliseconds

like, literally just "pause, girl, wait a sec." 💅

✨ SYNOPSIS ✨

#include <tcl.h>

Tcl_Sleep(ms)

🎀 ARGUMENTS 🎀

  • int ms (in) — Number of milliseconds to sleep. that's your lil countdown timer, your "give me a sec" number, your nap duration. 🛌

💖 DESCRIPTION 💖

okay so here's the tea: this procedure delays the calling process by the number of milliseconds given by the ms parameter, and then it returns after that time has elapsed. that's it. that's the whole job. she sleeps, she wakes up, she comes back. 😴➡️😳

where is this energy useful? the classics — things like flashing a button 🔘✨, where the delay is short and the application doesn't need to do anything while it waits. just vibes, just waiting, no multitasking required. lowkey the simplest possible relationship with time.

but bestie, hear me: for longer delays where the application needs to respond to other events during the delay, you should use the procedure Tcl_CreateTimerHandler instead of Tcl_Sleep. do not pass go, do not block your whole event loop, do not make your app freeze up like it saw something it shouldn't have. 💀 Tcl_Sleep blocks. Tcl_CreateTimerHandler lets your app keep living its life. choose wisely, queen. 👑

🔑 KEYWORDS 🔑

sleep, time, wait

that's the whole page, no cap. go forth and nap responsibly. 🫶

sign-off szn: this one's from the Tcl manual, version 7.5, page Tcl_Sleep(3tcl). mwah. 💋

📦 where this page comes from