Struct Executor

pub struct Executor { /* private fields */ }

A multi-threaded executor.

Implementations

impl Executor

pub fn new() -> Executor

Creates a new multi-threaded executor.

Examples

use multitask::Executor;

let ex = Executor::new();

pub fn spawn<T: Send + 'static>( &self, future: impl Future<Output = T> + Send + 'static, ) -> Task<T>

Spawns a future onto this executor.

Returns a Task handle for the spawned future.

Examples

use multitask::Executor;

let ex = Executor::new();
let task = ex.spawn(async { println!("hello") });

pub fn ticker(&self, notify: impl Fn() + Send + Sync + 'static) -> Ticker

Creates a new ticker for executing tasks.

In a multi-threaded executor, each executor thread will create its own ticker and then keep calling Ticker::tick() in a loop.

Examples

use blocking::block_on;
use multitask::Executor;
use std::thread;

let ex = Executor::new();

// Create two executor threads.
for _ in 0..2 {
    let (p, u) = parking::pair();
    let ticker = ex.ticker(move || u.unpark());
    thread::spawn(move || {
        loop {
            if !ticker.tick() {
                p.park();
            }
        }
    });
}

// Spawn a future and wait for one of the threads to run it.
let task = ex.spawn(async { 1 + 2 });
assert_eq!(block_on(task), 3);

Trait Implementations

impl Debug for Executor

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

Formats the value using the given formatter.

impl Default for Executor

fn default() -> Executor

Returns the “default value” for a type.

impl RefUnwindSafe for Executor

impl UnwindSafe for Executor