Async & Futures

11 pages in this section.

Why an `async fn` compiles to a lazy, poll-based state machine, why that state machine does nothing without an executor, and why self-referential state machines force the `Pin` API to exist.

Explainer Rust Async Futures

Async Basics

`async`/`await`, futures, and lazy execution.

Rust Async Futures Basics

The Future Trait

Rust Async Future Poll

Executors & Runtimes

Rust Async Executor Runtime

Pinning & Unpin

Rust Async Pin Unpin

async fn in Traits

Rust Async Traits Async Trait

Streams

Async iteration with the `Stream` trait.

Rust Async Streams Iteration

Combining Futures

`join!`, `select!`, and racing.

Rust Async Join Select

Cancellation & Timeouts

Dropping futures and deadlines.

Rust Async Cancellation Timeouts

Blocking in Async

Rust Async Blocking Spawn Blocking

Async Best Practices

Structuring async code that stays responsive.

Rust Async Best Practices List

Async & Futures

Search Documentation

Async & Futures