Struct greenie::fiber::Fiber

pub struct Fiber<T> { /* fields omitted */ }

Fiber objects are lightweight microthreads which are cooperatively scheduled. Only one can run at a given time and the Fiber::yield() or yield_thread functions must be used to switch execution from one fiber to another.

Methods

impl<T> Fiber<T>

pub fn new<F: FnOnce() -> T + Clone + 'static>(closure: F) -> Self

Create new fiber.

Example

use greenie::*;
create_main( || {
    let some_variable = 42;
    let fiber = Fiber::new(move || {
        println!("{}",some_variable);

        return "Complete";
    });

    fiber.start();

    println!("{}",fiber.join().unwrap());
});

pub fn new_capture<F: 'static, A: 'static + ApplyTo<F, Result = T> + Clone>(
    closure: F,
    args: A
) -> Self

Creates new fiber. Main difference from Fiber::new is that you can capture some variables from context much easier:

use greenie::*;
create_main( || {
    let some_variable = 42;
    let fiber = Fiber::new_capture( |v,_| {
        println!("{}",v);

        return "Complete";
    },(some_variable,()));

    fiber.start();

    println!("{}",fiber.join().unwrap());
});

pub fn yield_(&self)

pub fn start(&self) -> Result<(), &'static str>

Starts or resumes the execution of this fiber.

pub fn join(self) -> Result<T, Box<dyn Any>> where
    T: 'static, 

Waits for the associated fiber to finish.

pub fn is_alive(&self) -> bool

Returns true if the fiber hasn't ended yet, false if it has already ended.

pub fn suspend(&self)

Pause fiber execution.