Struct drone_core::fib::Chain

[+] Show declaration

pub struct Chain { /* fields omitted */ }

[−] Expand description

A lock-free list of fibers.

Implementations

impl Chain[−]

pub const fn new() -> Self[−]

Creates an empty fiber chain.

pub fn add<F: RootFiber>(&self, fib: F)[−]

Adds a fiber first in the chain.

pub fn is_empty(&self) -> bool[−]

Returns true if the chain is empty.

pub unsafe fn drain(
    &self
) -> Drain<'_, impl FnMut(*mut ListNode<Node<()>>) -> bool>[−]

Returns an iterator that advances each fiber in the chain, returning completed ones.

Examples

The returned iterator can be simply dropped, it’s destructor will drop all completed fibers:

use drone_core::fib::Chain;

let chain = Chain::new();
unsafe {
    drop(chain.drain()); // run the iterator and drop completed fibers
}

Check if there is at least one active fiber:

use drone_core::fib::Chain;

let chain = Chain::new();
let drain = unsafe { chain.drain() };
if drain.is_end() {
    println!("No active fibers to react to this interrupt");
}

Safety

This method must not be called again when the previous iterator is still alive.

Trait Implementations

impl Drop for Chain[+]

[+] Show hidden undocumented items

fn drop(&mut self)[−]

Executes the destructor for this type.