Seth Woolley's Man Viewer

vwait(n) - vwait, vwait - Process events until a variable is written - man n vwait

([section] manual, -k keyword, -K [section] search, -f whatis)
man plain no title

vwait(n)                     Tcl Built-In Commands                    vwait(n)



NAME
       vwait - Process events until a variable is written

SYNOPSIS
       vwait varName


DESCRIPTION
       This  command enters the Tcl event loop to process events, blocking the
       application if(3,n) no events are ready.   It  continues  processing  events
       until some event handler sets the value of variable varName.  Once var-
       Name has been set(7,n,1 builtins), the vwait command will return as soon as  the  event
       handler  that modified varName completes.  varName must globally scoped
       (either with a call to global for the varName, or with the full  names-
       pace path specification).

       In  some  cases the vwait command may not return immediately after var-
       Name is set.  This can happen if(3,n) the event handler  that  sets  varName
       does  not  complete immediately.  For example, if(3,n) an event handler sets
       varName and then itself calls vwait to wait for a  different  variable,
       then it may not return for a long time.  During this time(1,2,n) the top-level
       vwait is blocked waiting for the event handler to complete, so it  can-
       not return either.


SEE ALSO
       global(n)


KEYWORDS
       event, variable, wait



Tcl                                   8.0                             vwait(n)

References for this manual (incoming links)