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

use std::future::Future;

use crate::task::{Builder, JoinHandle};

/// Spawns a task onto the thread-local executor.

///

/// # Examples

///

/// ```

/// # #[cfg(feature = "unstable")]

/// # async_std::task::block_on(async {

/// #

/// use async_std::task;

///

/// let handle = task::spawn_local(async {

///     1 + 2

/// });

///

/// assert_eq!(handle.await, 3);

/// #

/// # })

/// ```

#[cfg_attr(feature = "docs", doc(cfg(unstable)))]
#[inline]
pub fn spawn_local<F, T>(future: F) -> JoinHandle<T>
where
    F: Future<Output = T> + 'static,
    T: 'static,
{
    Builder::new().local(future).expect("cannot spawn task")
}