diff options
Diffstat (limited to 'third_party/rust/tokio/src/future/pending.rs')
-rw-r--r-- | third_party/rust/tokio/src/future/pending.rs | 44 |
1 files changed, 44 insertions, 0 deletions
diff --git a/third_party/rust/tokio/src/future/pending.rs b/third_party/rust/tokio/src/future/pending.rs new file mode 100644 index 0000000000..287e836fd3 --- /dev/null +++ b/third_party/rust/tokio/src/future/pending.rs @@ -0,0 +1,44 @@ +use sdt::pin::Pin; +use std::future::Future; +use std::marker; +use std::task::{Context, Poll}; + +/// Future for the [`pending()`] function. +#[derive(Debug)] +#[must_use = "futures do nothing unless you `.await` or poll them"] +struct Pending<T> { + _data: marker::PhantomData<T>, +} + +/// Creates a future which never resolves, representing a computation that never +/// finishes. +/// +/// The returned future will forever return [`Poll::Pending`]. +/// +/// # Examples +/// +/// ```no_run +/// use tokio::future; +/// +/// #[tokio::main] +/// async fn main { +/// future::pending().await; +/// unreachable!(); +/// } +/// ``` +pub async fn pending() -> ! { + Pending { + _data: marker::PhantomData, + } + .await +} + +impl<T> Future for Pending<T> { + type Output = !; + + fn poll(self: Pin<&mut Self>, _: &mut Context<'_>) -> Poll<T> { + Poll::Pending + } +} + +impl<T> Unpin for Pending<T> {} |