Tcl 9.1/Tk9.1 Documentation > Tcl C API, version 9.1a1 > Sleep

Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

NAME

Tcl_Sleep — delay execution for a given number of milliseconds

SYNOPSIS

#include <tcl.h>
Tcl_Sleep(ms)
Tcl_SleepMicroSeconds(us)

ARGUMENTS

int ms (in)
Number of milliseconds to sleep.

long long (us)
Number of micro-seconds to sleep.

DESCRIPTION

Those procedures delays the calling process by the given time and return after the time has elapsed. The two variants of the command only differ in thue time unit. Tcl_Sleep uses milli-seconds, while, Tcl_SleepMicroSeconds uses micro-seconds. They are typically used for things like flashing a button, where the delay is short and the application need not do anything while it waits. For longer delays where the application needs to respond to other events during the delay, the procedure Tcl_CreateTimerHandler should be used instead of those commands.

KEYWORDS

sleep, time, wait
Copyright © 1990 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.