kotlinx.coroutines

Interface CompletableDeferred<T>

All Superinterfaces:

Deferred<T>, Job

public CompletableDeferred<T>
extends Deferred<T>

A interface Deferred that can be completed via public functions CompletableDeferred.complete or Job.cancel.

Note, that CompletableDeferred.complete functions returns false when this deferred value is already complete or completing, while Job.cancel returns true as long the deferred is still cancelling and the corresponding exception is incorporated into the final Deferred.getCompletionExceptionOrNull.

An instance of completable deferred can be created by CompletableDeferred() function in active state.

All functions on this interface and on all interfaces derived from it are thread-safe and can be safely invoked from concurrent coroutines without external synchronization.

See Also:

interface Deferred, CompletableDeferred.complete, Job.cancel, CompletableDeferred.complete, Job.cancel, Deferred.getCompletionExceptionOrNull

Nested Class Summary

Nested classes/interfaces inherited from interface kotlinx.coroutines.Job

Job.DefaultImpls, Job.Key

Field Summary

Fields inherited from interface kotlinx.coroutines.Job

Key

Method Summary

Modifier and Type	Method and Description
boolean	complete(T value) Completes this deferred value with a given value. The result is true if this deferred was completed as a result of this invocation and false otherwise (if it was already completed).
boolean	completeExceptionally(java.lang.Throwable exception) Completes this deferred value exceptionally with a given exception. The result is true if this deferred was completed as a result of this invocation and false otherwise (if it was already completed).

Methods inherited from interface kotlinx.coroutines.Deferred

await, getCompleted, getCompletionExceptionOrNull, getOnAwait

Methods inherited from interface kotlinx.coroutines.Job

cancel, getChildren, getOnJoin, invokeOnCompletion, isActive, isCancelled, isCompleted, join, start

Method Detail

complete

boolean complete(T value)

Completes this deferred value with a given value. The result is true if this deferred was completed as a result of this invocation and false otherwise (if it was already completed).

Repeated invocations of this function have no effect and always produce false.

completeExceptionally

boolean completeExceptionally(java.lang.Throwable exception)

Completes this deferred value exceptionally with a given exception. The result is true if this deferred was completed as a result of this invocation and false otherwise (if it was already completed).

Repeated invocations of this function have no effect and always produce false.