async-rs / async-rs/async-std

Book: explain fuse and select

Open
#88 0 comments 1 reaction 0 assignees View on GitHub
documentation
Dominant language
Rust
Stars
4.1k
Forks
339
PR merge metrics
No merged PRs in 30d

Description

The `select!` macro together with `FuturesExt::fuse`, `FusedStream` and `FusedFuture` is a pretty powerful mechanism which isn't all that easy to understand. The [current version of the doc](https://github.com/async-rs/async-std/blob/0156dc879bc67e313ef123978a8edfb24ae36fae/docs/src/tutorial/handling_disconnection.md) only mentions `select!` in passing and doesn't address `fuse` at all.

Linking to the [respective section in the async book](https://rust-lang.github.io/async-book/06_multiple_futures/03_select.html), or to the trait and function definitions might help, although I am not sure how stable they are.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.