DispatchClosure
A map of Element instances. Every element has a unique Key. By design DispatchClosure is immutable. However, its elements might mutate depending on their implementation.
This concept is analogous to CoroutineContext and acts in the same way.
Examples below shows how to combine and access elements:
val closure = A(1) + B("arg") + A(2)
val elementA = closure[A] // Returns A(2). A(1) was replaced.
val elementB = closure[B] // Returns B("arg")
val elementC = closure.find(C) // Returns null
val elementC = closure[C] // Throws exceptionSee also
Types
A single element of a DispatchClosure. By default, it acts like a DispatchClosure that contains only itself.
Functions
Returns Element associated with the key or throws MissingClosureElementException.
Returns a closure without the element with a given key
Returns elements form this DispatchClosure as a Map.
Inheritors
Extensions
Launches a foreground job using this closure. By default, it's launched in a scope provided by DispatchCoroutineScope. This behaviour might be changed by dispatchJobIn or joinDispatchJob. Because this function uses local closure, calling it outside dispatch should not be done, because it might result in unexpected behaviour.
Returns this closure with local changes.
Runs block that must register a foreground job. It adds SingleForegroundJobRegistry to local closure to allow proper job registration. Local closure change creates a new frame if newFrame is true.
Changes LocalClosureContainer with a given closure for a time of block execution.