Enum ThreadStrategy

Source

pub enum ThreadStrategy {
    MainThread,
    WorkerThread,
}

Expand description

Thread execution strategy for C wrappers.

Variants§

§

MainThread

Execute on main R thread with with_r_unwind_protect. Default.

All code runs on R’s main thread. Errors are returned as tagged SEXP values (via make_rust_condition_value) and the R wrapper raises structured condition objects. Simpler execution model with better R integration.

Also required when:

Function takes SEXP inputs (not Send)
Function returns raw SEXP
Instance method (self_ptr isn’t Send)
Function uses variadic dots (Dots type isn’t Send)
#[miniextendr(check_interrupt)] used

§

WorkerThread

Execute on worker thread with panic catching. Opt-in via #[miniextendr(worker)].

Structure:

Argument conversion on main thread
Function execution on worker thread via run_on_worker
SEXP conversion on main thread with with_r_unwind_protect

Trait Implementations§

Source §

impl Clone for ThreadStrategy

Source §

fn clone(&self) -> ThreadStrategy

Returns a duplicate of the value. Read more

1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more

Source §

impl Debug for ThreadStrategy

Source §

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

Formats the value using the given formatter. Read more

Source §

impl Eq for ThreadStrategy

Source §

#[doc(hidden)]
fn assert_fields_are_eq(&self)

🔬This is a nightly-only experimental API. (derive_eq_internals)

1.0.0 (const: unstable) · Source§

#[doc(hidden)]
fn assert_receiver_is_total_eq(&self)

👎Deprecated since 1.95.0:

implementation detail of #[derive(Eq)]

Source §

impl PartialEq for ThreadStrategy

Source §

fn eq(&self, other: &ThreadStrategy) -> bool

Tests for self and other values to be equal, and is used by ==.

1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

Source §

impl Copy for ThreadStrategy

Source §

impl StructuralPartialEq for ThreadStrategy

Source §

impl TrivialClone for ThreadStrategy

Auto Trait Implementations§

§

impl UnwindSafe for ThreadStrategy

Blanket Implementations§

Source §

impl<T> Any for T
where T: 'static + ?Sized,

Source §

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

Source §

impl<T> Borrow<T> for T
where T: ?Sized,

Source §

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

Source §

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source §

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

Source §

impl<T> CloneToUninit for T
where T: Clone,

Source §

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)

Performs copy-assignment from self to dest. Read more

Source §

impl<T> From<T> for T

Source §

fn from(t: T) -> T

Returns the argument unchanged.

Source §

impl<T, U> Into for T
where U: From<T>,

Source §

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source §