Create a future that is immediately ready with an error value.

Examples

# futures::executor::block_on(async {
use futures::future;

let a = future::err::<i32, i32>(1);
assert_eq!(a.await, Err(1));
# });