Struct CurrentThread

pub struct CurrentThread<P: Park = ParkThread> { /* private fields */ }

Executes tasks on the current thread

Implementations

impl CurrentThread<ParkThread>

pub fn new() -> Self

Create a new instance of CurrentThread.

impl<P: Park> CurrentThread<P>

pub fn new_with_park(park: P) -> Self

Create a new instance of CurrentThread backed by the given park handle.

pub fn is_idle(&self) -> bool

Returns true if the executor is currently idle.

An idle executor is defined by not currently having any spawned tasks.

Note that this method is inherently racy – if a future is spawned from a remote Handle, this method may return true even though there are more futures to be executed.

pub fn spawn<F>(&mut self, future: F) -> &mut Self

where F: Future<Item = (), Error = ()> + 'static,

Spawn the future on the executor.

This internally queues the future to be executed once run is called.

pub fn block_on<F>( &mut self, future: F, ) -> Result<F::Item, BlockError<F::Error>>

where F: Future,

Synchronously waits for the provided future to complete.

This function can be used to synchronously block the current thread until the provided future has resolved either successfully or with an error. The result of the future is then returned from this function call.

Note that this function will also execute any spawned futures on the current thread, but will not block until these other spawned futures have completed.

The caller is responsible for ensuring that other spawned futures complete execution.

pub fn run(&mut self) -> Result<(), RunError>

Run the executor to completion, blocking the thread until all spawned futures have completed.

pub fn run_timeout(&mut self, duration: Duration) -> Result<(), RunTimeoutError>

Run the executor to completion, blocking the thread until all spawned futures have completed or duration time has elapsed.

pub fn turn(&mut self, duration: Option<Duration>) -> Result<Turn, TurnError>

Perform a single iteration of the event loop.

This function blocks the current thread even if the executor is idle.

pub fn enter<'a>(&'a mut self, enter: &'a mut Enter) -> Entered<'a, P>

Bind CurrentThread instance with an execution context.

pub fn get_park(&self) -> &P

Returns a reference to the underlying Park instance.

pub fn get_park_mut(&mut self) -> &mut P

Returns a mutable reference to the underlying Park instance.

pub fn handle(&self) -> Handle

Get a new handle to spawn futures on the executor

Different to the executor itself, the handle can be sent to different threads and can be used to spawn futures on the executor.

Trait Implementations

impl<P: Park> Debug for CurrentThread<P>

fn fmt(&self, fmt: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<P: Park> Drop for CurrentThread<P>

fn drop(&mut self)

Executes the destructor for this type.

impl Executor for CurrentThread

fn spawn( &mut self, future: Box<dyn Future<Item = (), Error = ()> + Send>, ) -> Result<(), SpawnError>

Spawns a future object to run on this executor.

fn status(&self) -> Result<(), SpawnError>

Provides a best effort hint to whether or not spawn will succeed.

impl<T> TypedExecutor<T> for CurrentThread

where T: Future<Item = (), Error = ()> + 'static,

fn spawn(&mut self, future: T) -> Result<(), SpawnError>

Spawns a future to run on this executor.

fn status(&self) -> Result<(), SpawnError>

Provides a best effort hint to whether or not spawn will succeed.