Module completion::future[−][src]

Utilities for the CompletionFuture trait.

Unlike the futures crate, all the joining futures (functions like zip, race, zip_all, etc) in this module adopt an efficient polling strategy, where they only poll the futures that issued wakeups, instead of polling every single future whenever just one of them issues a wakeup. This reduces their complexity from O(n^2) to O(n), making them suitable for large numbers of futures.

Re-exports

pub use core::future::pending;

pub use core::future::ready;

pub use core::future::Pending;

pub use core::future::Ready;

pub use completion_core::CompletionFuture;

Structs

CatchUnwind	`std` Future for `CompletionFutureExt::catch_unwind`.
NowOrNever	Future for `CompletionFutureExt::now_or_never`.
Race	`std` Future for `race`.
RaceAll	`std` Future for `race_all`.
RaceOk	`std` Future for `race_ok`.
RaceOkAll	`std` Future for `race_ok_all`. If all the futures fail, this returns a `RaceOkAllErrors`.
RaceOkAllErrors	`std` An iterator over the errors of the futures in a `RaceOkAll`.
TryZip	`std` Future for `try_zip`.
TryZipAll	`std` Future for `try_zip_all`. On success, this outputs a `TryZipAllOutput`.
TryZipAllOutput	`std` An iterator over the successful outputs of futures in a `TryZipAll`.
Zip	`std` Future for `zip`.
ZipAll	`std` Future for `zip_all`. This outputs a `ZipAllOutput`.
ZipAllOutput	`std` An iterator over the outputs of futures in a `ZipAll`.

Traits

CompletionFutureExt	Extension trait for `CompletionFuture`.
FutureExt	Extension trait for converting `Future`s to `CompletionFuture`s.

Functions

block_on	`std` Blocks the current thread on a completion future.
race	`std` Wait for the first future in a tuple to complete.
race_all	`std` Wait for the first future in an iterator to complete.
race_ok	`std` Wait for the first future in a tuple to successfully complete.
race_ok_all	`std` Wait for the first future in an iterator to successfully complete.
try_zip	`std` Wait for all the futures in a tuple to successfully complete or one to return an error.
try_zip_all	`std` Wait for all the futures in an iterator to successfully complete or one to return an error.
zip	`std` Wait for all the futures in a tuple to complete.
zip_all	`std` Wait for all the futures in an iterator to complete.

Type Definitions

BoxCompletionFuture	`alloc` A type-erased completion future.
LocalBoxCompletionFuture	`alloc` A type-erased completion future that cannot be send across threads.