Cancellation is advisory: it never interrupts running code. The
worker skips a task that is still queued. A task already executing
runs to completion, and its result is dropped. Collecting a cancelled
handle raises mizu_error_cancelled (see mizu_error).
Arguments
- task
a task handle from
mizu_submit(), or a map handle frommizu_map()/mizu_map_run().
Value
Invisibly, TRUE if this call cancelled the task. FALSE if
the call was too late: the task completed, was already cancelled, or
its pool is gone.
Details
On a map handle from mizu_map() / mizu_map_run(), the shared cancel word
of the map is set: executing runners stop within about one batch of their
next transition, and every outstanding runner task is cancelled as above. A
blocking mizu_collect() on the handle raises mizu_error_cancelled, and a
pending promise rejects with it.
Examples
p <- mizu_pool()
t <- mizu_submit(p, runif(1))
mizu_cancel(t)
mizu_pool_stop(p)