object's event processing loop to execute at most one handler.
function blocks until one handler has been dispatched, or until the
has been stopped.
The number of handlers that were executed. A zero return value implies
object is stopped (the
stopped() function returns
Subsequent calls to
poll_one() will return immediately unless there
is a prior call to
Thrown on failure.