1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71
//! Asynchronous values. #[cfg(feature = "timer")] use tokio_timer::Timeout; #[cfg(feature = "timer")] use std::time::Duration; #[doc(inline)] pub use futures_util::future::{err, ok, pending, poll_fn, ready}; #[doc(inline)] pub use std::future::Future; /// An extension trait for `Future` that provides a variety of convenient /// combinator functions. /// /// Currently, there only is a [`timeout`] function, but this will increase /// over time. /// /// Users are not expected to implement this trait. All types that implement /// `Future` already implement `FutureExt`. /// /// This trait can be imported directly or via the Tokio prelude: `use /// tokio::prelude::*`. /// /// [`timeout`]: #method.timeout pub trait FutureExt: Future { /// Creates a new future which allows `self` until `timeout`. /// /// This combinator creates a new future which wraps the receiving future /// with a timeout. The returned future is allowed to execute until it /// completes or `timeout` has elapsed, whichever happens first. /// /// If the future completes before `timeout` then the future will resolve /// with that item. Otherwise the future will resolve to an error. /// /// The future is guaranteed to be polled at least once, even if `timeout` /// is set to zero. /// /// # Examples /// /// ``` /// #![feature(async_await)] /// /// use tokio::prelude::*; /// use std::time::Duration; /// /// async fn long_future() { /// // do work here /// } /// /// # async fn dox() { /// let res = long_future() /// .timeout(Duration::from_secs(1)) /// .await; /// /// if res.is_err() { /// println!("operation timed out"); /// } /// # } /// ``` #[cfg(feature = "timer")] fn timeout(self, timeout: Duration) -> Timeout<Self> where Self: Sized, { Timeout::new(self, timeout) } } impl<T: ?Sized> FutureExt for T where T: Future {}