kotlinx.coroutines.experimental

Class AwaitKt

kotlinx.coroutines.experimental.AwaitKt

public class AwaitKt

Method Summary

Modifier and Type	Method and Description
static <T> java.lang.Object	awaitAll(Deferred<T>[] deferreds, kotlin.coroutines.experimental.Continuation<? super java.util.List<? extends T>> p) Awaits for completion of given deferred values without blocking a thread and resumes normally with the list of values when all deferred computations are complete or resumes with the first thrown exception if any of computations complete exceptionally including cancellation.
static <T> java.lang.Object	awaitAll(java.util.Collection<? extends kotlinx.coroutines.experimental.Deferred<? extends T>> $receiver, kotlin.coroutines.experimental.Continuation<? super java.util.List<? extends T>> p) Awaits for completion of given deferred values without blocking a thread and resumes normally with the list of values when all deferred computations are complete or resumes with the first thrown exception if any of computations complete exceptionally including cancellation.
static java.lang.Object	joinAll(Job[] jobs, kotlin.coroutines.experimental.Continuation<? super kotlin.Unit> p) Suspends current coroutine until all given jobs are complete. This method is semantically equivalent to joining all given jobs one by one with jobs.forEach { it.join() }.
static java.lang.Object	joinAll(java.util.Collection<? extends kotlinx.coroutines.experimental.Job> $receiver, kotlin.coroutines.experimental.Continuation<? super kotlin.Unit> p) Suspends current coroutine until all given jobs are complete. This method is semantically equivalent to joining all given jobs one by one with forEach { it.join() }.

Method Detail

awaitAll

public static <T> java.lang.Object awaitAll(Deferred<T>[] deferreds,
                                            kotlin.coroutines.experimental.Continuation<? super java.util.List<? extends T>> p)

Awaits for completion of given deferred values without blocking a thread and resumes normally with the list of values when all deferred computations are complete or resumes with the first thrown exception if any of computations complete exceptionally including cancellation.

This function is not equivalent to deferreds.map { it.await() } which fails only when when it sequentially gets to wait the failing deferred, while this awaitAll fails immediately as soon as any of the deferreds fail.

This suspending function is cancellable. If the interface Job of the current coroutine is cancelled or completed while this suspending function is waiting, this function immediately resumes with CancellationException.

See Also:

interface Job

awaitAll

public static <T> java.lang.Object awaitAll(java.util.Collection<? extends kotlinx.coroutines.experimental.Deferred<? extends T>> $receiver,
                                            kotlin.coroutines.experimental.Continuation<? super java.util.List<? extends T>> p)

Awaits for completion of given deferred values without blocking a thread and resumes normally with the list of values when all deferred computations are complete or resumes with the first thrown exception if any of computations complete exceptionally including cancellation.

This function is not equivalent to this.map { it.await() } which fails only when when it sequentially gets to wait the failing deferred, while this awaitAll fails immediately as soon as any of the deferreds fail.

This suspending function is cancellable. If the interface Job of the current coroutine is cancelled or completed while this suspending function is waiting, this function immediately resumes with CancellationException.

See Also:

interface Job

joinAll

public static java.lang.Object joinAll(Job[] jobs,
                                       kotlin.coroutines.experimental.Continuation<? super kotlin.Unit> p)

Suspends current coroutine until all given jobs are complete. This method is semantically equivalent to joining all given jobs one by one with jobs.forEach { it.join() }.

This suspending function is cancellable. If the interface Job of the current coroutine is cancelled or completed while this suspending function is waiting, this function immediately resumes with CancellationException.

See Also:

interface Job

joinAll

public static java.lang.Object joinAll(java.util.Collection<? extends kotlinx.coroutines.experimental.Job> $receiver,
                                       kotlin.coroutines.experimental.Continuation<? super kotlin.Unit> p)

Suspends current coroutine until all given jobs are complete. This method is semantically equivalent to joining all given jobs one by one with forEach { it.join() }.

This suspending function is cancellable. If the interface Job of the current coroutine is cancelled or completed while this suspending function is waiting, this function immediately resumes with CancellationException.

See Also:

interface Job