Struct actix_web::rt::Arbiter

pub struct Arbiter { /* fields omitted */ }

An Arbiter represents a thread that provides an asynchronous execution environment for futures and functions.

When an arbiter is created, it spawns a new OS thread, and hosts an event loop.

Implementations

impl Arbiter

pub fn new() -> Arbiter

Spawn a new Arbiter thread and start its event loop.

Panics

Panics if a System is not registered on the current thread.

pub fn handle(&self) -> ArbiterHandle

Return a handle to the this Arbiter’s message sender.

pub fn current() -> ArbiterHandle

Return a handle to the current thread’s Arbiter’s message sender.

Panics

Panics if no Arbiter is running on the current thread.

pub fn stop(&self) -> bool

Stop Arbiter from continuing it’s event loop.

Returns true if stop message was sent successfully and false if the Arbiter has been dropped.

pub fn spawn<Fut>(&self, future: Fut) -> bool where
    Fut: Future<Output = ()> + Send + 'static, 

Send a future to the Arbiter’s thread and spawn it.

If you require a result, include a response channel in the future.

Returns true if future was sent successfully and false if the Arbiter has died.

pub fn spawn_fn<F>(&self, f: F) -> bool where
    F: FnOnce() + Send + 'static, 

Send a function to the Arbiter’s thread and execute it.

Any result from the function is discarded. If you require a result, include a response channel in the function.

Returns true if function was sent successfully and false if the Arbiter has died.

pub fn join(self) -> Result<(), Box<dyn Any + 'static + Send, Global>>

Wait for Arbiter’s event loop to complete.

Joins the underlying OS thread handle. See JoinHandle::join.

Trait Implementations

impl Debug for Arbiter

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

Formats the value using the given formatter.