--- libev/ev.pod 2008/04/02 05:51:40 1.139 +++ libev/ev.pod 2008/04/02 06:34:51 1.140 @@ -2290,6 +2290,20 @@ so while the overhead might be noticable, it doesn't apply to repeated calls to C. +=item bool = ev_async_pending (ev_async *) + +Returns a non-zero value when C has been called on the +watcher but the event has not yet been processed (or even noted) by the +event loop. + +C sets a flag in the watcher and wakes up the loop. When +the loop iterates next and checks for the watcher to have become active, +it will reset the flag again. C can be used to very +quickly check wether invoking the loop might be a good idea. + +Not that this does I check wether the watcher itself is pending, only +wether it has been requested to make this watcher pending. + =back