Struct jlrs::memory::frame::AsyncGcFrame

pub struct AsyncGcFrame<'frame> { /* fields omitted */ }

A frame that can be used to root values and dispatch Julia function calls to another thread with Value::call_async. An AsyncGcFrame is available by implementing the JuliaTask trait, this struct provides create a nested async scope.

Roots are stored in slots, each slot can contain one root. Frames created with slots will preallocate that number of slots. Frames created without slots will dynamically create new slots as needed. A frame is able to create at least 16 slots. If there is sufficient capacity available, a new frame will use this remaining capacity. If the capacity is insufficient, more stack space is allocated.

Implementations

impl<'frame> AsyncGcFrame<'frame>

pub async fn async_value_scope<'nested, 'data, F, G>(
    &'nested mut self,
    func: F
) -> JlrsResult<Value<'frame, 'data>> where
    G: Future<Output = JlrsResult<UnrootedValue<'frame, 'data, 'nested>>>,
    F: FnOnce(Output<'frame>, &'nested mut AsyncGcFrame<'nested>) -> G, 

An async version of value_scope. Rather than a closure, it takes an async closure that provides a new AsyncGcFrame.

pub async fn async_value_scope_with_slots<'nested, 'data, F, G>(
    &'nested mut self,
    capacity: usize,
    func: F
) -> JlrsResult<Value<'frame, 'data>> where
    G: Future<Output = JlrsResult<UnrootedValue<'frame, 'data, 'nested>>>,
    F: FnOnce(Output<'frame>, &'nested mut AsyncGcFrame<'nested>) -> G, 

An async version of value_scope_with_slots. Rather than a closure, it takes an async closure that provides a new AsyncGcFrame.

pub async fn async_result_scope<'nested, 'data, F, G>(
    &'nested mut self,
    func: F
) -> JlrsResult<JuliaResult<'frame, 'data>> where
    G: Future<Output = JlrsResult<UnrootedResult<'frame, 'data, 'nested>>>,
    F: FnOnce(Output<'frame>, &'nested mut AsyncGcFrame<'nested>) -> G, 

An async version of result_scope. Rather than a closure, it takes an async closure that provides a new AsyncGcFrame.

pub async fn async_result_scope_with_slots<'nested, 'data, F, G>(
    &'nested mut self,
    capacity: usize,
    func: F
) -> JlrsResult<JuliaResult<'frame, 'data>> where
    G: Future<Output = JlrsResult<UnrootedResult<'frame, 'data, 'nested>>>,
    F: FnOnce(Output<'frame>, &'nested mut AsyncGcFrame<'nested>) -> G, 

An async version of result_scope_with_slots. Rather than a closure, it takes an async closure that provides a new AsyncGcFrame.

pub async fn async_scope<'nested, T, F, G>(
    &'nested mut self,
    func: F
) -> JlrsResult<T> where
    T: 'frame,
    G: Future<Output = JlrsResult<T>>,
    F: FnOnce(&'nested mut AsyncGcFrame<'nested>) -> G, 

An async version of frame. Rather than a closure, it takes an async closure that provides a new AsyncGcFrame.

pub async fn async_scope_with_slots<'nested, T, F, G>(
    &'nested mut self,
    capacity: usize,
    func: F
) -> JlrsResult<T> where
    T: 'frame,
    G: Future<Output = JlrsResult<T>>,
    F: FnOnce(&'nested mut AsyncGcFrame<'nested>) -> G, 

An async version of scope_with_slots. Rather than a closure, it takes an async closure that provides a new AsyncGcFrame.

pub fn n_roots(&self) -> usize

Returns the number of values currently rooted in this frame.

pub fn n_slots(&self) -> usize

Returns the number of slots that are currently allocated to this frame.

pub fn capacity(&self) -> usize

Returns the maximum number of slots this frame can use.

pub fn alloc_slots(&mut self, additional: usize) -> bool

Try to allocate additional slots in the current frame. Returns true on success, or false if self.n_slots() + additional > self.capacity().

Trait Implementations

impl<'frame> Drop for AsyncGcFrame<'frame>

fn drop(&mut self)

Executes the destructor for this type.

impl<'frame> Frame<'frame> for AsyncGcFrame<'frame>

#[must_use]

fn alloc_slots(&mut self, additional: usize) -> bool

Reserve additional slots in the current frame. Returns true on success, or false if self.n_slots() + additional > self.capacity().

fn n_roots(&self) -> usize

Returns the number of values currently rooted in this frame.

fn n_slots(&self) -> usize

Returns the number of slots that are currently allocated to this frame.

fn capacity(&self) -> usize

Returns the maximum number of slots this frame can use.

fn as_scope(&mut self) -> &mut Self

This method takes a mutable reference to a frame and returns it; this method can be used as an alternative to reborrowing a frame with &mut *frame when a Scope is needed.