yield in Eventspaces

Yields control to event dispatching. See Eventspaces for details.

A handler procedure invoked by the system during a call to yield can itself call yield, creating an additional level of nested (but single-threaded) event handling.

See also sleep/yield .

• (yield) -> boolean

  Dispatches an unspecified number of events, but only if the current thread is the current eventspace's handler thread (otherwise, there is no effect). The result is #t if any events may have been handled, #f otherwise.

  
  

• (yield v) -> value
     v : 'wait or event

  If v is 'wait, and yield is called in the handler thread of an eventspace, it starts processing events in that eventspace until

  • no top-level windows in the eventspace are visible;

  • no timers in the eventspace are running;

  • no callbacks are queued in the eventspace; and

  • no menu-bar% has been created for the eventspace with 'root (i.e., creating a 'root menu bar prevents an eventspace from ever unblocking).

  When called in a non-handler thread, returns immediately. In either case, the result is #t.

  Evaluating (yield 'wait) is thus similar to (yield (current-eventspace)), except that it is sensitive to whether the current thread is a handler thread, instead of the value of the current-eventspace parameter.

  If v is an event in MzScheme's sense (not to be confused with a GUI event), yield blocks on v in the same way as MzScheme's sync, section 7.7 in PLT MzScheme: Language Manual, except that it may start a sync on v multiple times (but it will complete a sync on v at most one time). If the current thread is the current eventspace's handler thread, events are dispatched until a v sync succeeds on a MrEd event boundary. For other threads, calling yield with a MzScheme event is equivalent to calling sync. In either case, the result is the same that of sync; however, if a wrapper procedure is associated with v via handle-evt, it is not called in tail position with respect to the yield.

  Always use (yield v) instead of a busy-wait loop.