wiki/content/20201120110842-pending.md

37 lines
533 B
Markdown

---
date: 2020-11-20
id: 048ee80a-c058-4a41-8087-9ce3649302ba
title: pending
---
# Description
pending[^1] creates a future which never resovles, representing a
computation that never finishes.
# Declaration
``` rust
pub fn pending<T>() -> Pending<T>
```
# Notable traits
``` rust
impl<T> Future for Pending<T>
type Output = T;
```
# Examples
``` rust
use core::future;
let future = future::pending();
let () = future.await;
unreachable!();
```
# Footnotes
[^1]: <https://doc.rust-lang.org/std/future/fn.pending.html>