Struct EHandle

pub struct EHandle { /* private fields */ }

A handle to an executor.

Implementations

impl EHandle

pub fn local() -> Self

Returns the thread-local executor.

Panics

If called outside the context of an active async executor.

pub fn global_scope(&self) -> &ScopeHandle

The root scope of the executor.

This can be used to spawn tasks that live as long as the executor, and to create shorter-lived child scopes.

Most users should create an owned scope with Scope::new instead of using this method.

pub fn port(&self) -> &Port

Get a reference to the Fuchsia zx::Port being used to listen for events.

pub fn register_receiver<T>(&self, receiver: Arc<T>) -> ReceiverRegistration<T>

where T: PacketReceiver,

Registers a PacketReceiver with the executor and returns a registration. The PacketReceiver will be deregistered when the Registration is dropped.

pub fn spawn_detached(&self, future: impl Future<Output = ()> + Send + 'static)

Spawn a new task to be run on this executor.

Tasks spawned using this method must be thread-safe (implement the Send trait), as they may be run on either a singlethreaded or multithreaded executor.

pub fn spawn_local_detached(&self, future: impl Future<Output = ()> + 'static)

Spawn a new task to be run on this executor.

This is similar to the spawn_detached method, but tasks spawned using this method do not have to be threads-safe (implement the Send trait). In return, this method requires that this executor is a LocalExecutor.

pub fn poll_tasks(&self, callback: impl FnOnce())

Calls callback in the context of the executor and then polls (a limited number of) tasks that are ready to run. If tasks remain ready and no other threads are running, a thread will be woken. This can end up being a performance win in the case that the queue can be cleared without needing to wake any other thread.

Panics

If called on a single-threaded executor or if this thread is a thread managed by the executor.

Trait Implementations

impl Clone for EHandle

fn clone(&self) -> EHandle

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EHandle

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

Formats the value using the given formatter.