Trait tarantool::fiber::Callee

pub trait Callee {
    type Args;
    type JoinHandle;
    unsafe fn start_fiber(self, inner: NonNull<Fiber>) -> Self::JoinHandle;
    unsafe fn parse_args(args: VaList) -> Self::Args;
    unsafe fn invoke(a: Self::Args);
}

Callee Types implementing this trait represent Fyber configurations relating to the kind of the fiber function. Currently only 2 kinds of functions are supported:

• FiberFunc: a no arguments function that returns a value
• FiberProc: a no arguments function that doesn’t return a value

TODO: add support for functions which take arguments?

Associated Types

type Args

Arguments for the trampoline function which will be passed through the va_list::VaList

type JoinHandle

JoinHandle type which will be returned from the Fyber::spawn function

Required methods

unsafe fn start_fiber(self, inner: NonNull<Fiber>) -> Self::JoinHandle

This function is called within Fyber::spawn to prepare the arguments for and invoke the [ffi::fiber_start] function.

Safety

This function is unsafe, because it is very easy to mess things up when preparing arugments.

unsafe fn parse_args(args: VaList) -> Self::Args

This function is called within Fyber::trampoline to extract the arguments from the va_list::VaList.

Safety

This function is unsafe, because it is very easy to mess things up when extracting arugments.

unsafe fn invoke(a: Self::Args)

This function is called within Fyber::trampoline to invoke the underlying callee function and process it’s results.

Safety

This function is unsafe, because it is very easy to mess things up when storing the callee’s result values.

Implementors

impl<'f, F> Callee for FiberProc<'f, F> where
    F: FnOnce(),
    F: 'f, 

type JoinHandle = UnitJoinHandle<'f>

type Args = Box<F>

impl<'f, F, T> Callee for FiberFunc<'f, F, T> where
    F: FnOnce() -> T,
    F: 'f,
    T: 'f, 

type JoinHandle = JoinHandle<'f, T>

type Args = (Box<F>, *mut Option<T>)