async/await

At a high level, async Rust code looks very much like “normal” sequential code:

  1. use futures::executor::block_on;
  3. async fn count_to(count: i32) {
  4.     for i in 0..count {
  5.         println!("Count is: {i}!");
  6.     }
  7. }
  9. async fn async_main(count: i32) {
  10.     count_to(count).await;
  11. }
  13. fn main() {
  14.     block_on(async_main(10));
  15. }

This slide should take about 6 minutes.

Key points:

  • Note that this is a simplified example to show the syntax. There is no long running operation or any real concurrency in it!

  • The “async” keyword is syntactic sugar. The compiler replaces the return type with a future.

  • You cannot make main async, without additional instructions to the compiler on how to use the returned future.

  • You need an executor to run async code. block_on blocks the current thread until the provided future has run to completion.

  • .await asynchronously waits for the completion of another operation. Unlike block_on, .await doesn’t block the current thread.

  • .await can only be used inside an async function (or block; these are introduced later).