Enum AltrepGuard

Source

pub enum AltrepGuard {
    Unsafe,
    RustUnwind,
    RUnwind,
}

Expand description

Controls the panic/error guard used around ALTREP trampoline callbacks.

Each mode trades off safety vs performance:

Unsafe: No protection. If the callback panics, behavior is undefined (unwinding through C frames). Use only for trivial callbacks that cannot panic.
RustUnwind: Wraps in catch_unwind, converting Rust panics to R errors. Suitable for pure-Rust callbacks.
RUnwind: Wraps in R_UnwindProtect, catching both Rust panics and R longjmp errors. This is the default. Use when ALTREP callbacks invoke R API functions that might error (e.g., Rf_allocVector, Rf_eval).

The guard is selected via the const GUARD associated constant on the Altrep trait. Since it is a const, the compiler eliminates dead branches at monomorphization time — zero runtime overhead for the chosen mode.

Variants§

§

Unsafe

No protection. Fastest, but if the callback panics, behavior is undefined.

§

RustUnwind

catch_unwind — catches Rust panics, converts to R errors.

§

RUnwind

with_r_unwind_protect — catches both Rust panics and R longjmps. Use when ALTREP callbacks invoke R API functions that might error.

Trait Implementations§

Source §

impl Clone for AltrepGuard

Source §

fn clone(&self) -> Self

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 Copy for AltrepGuard

Source §

impl Debug for AltrepGuard

Source §

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

Formats the value using the given formatter. Read more

Source §

impl Eq for AltrepGuard

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 §

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

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

Source §

impl PartialEq for AltrepGuard

Source §

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

Equality operator ==. Read more

1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more

Source §

impl StructuralPartialEq for AltrepGuard

Source §

impl TrivialClone for AltrepGuard

Auto Trait Implementations§

§

impl UnwindSafe for AltrepGuard

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> ConsumingFallible for T
where T: Clone,

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 §

impl<T> Printable for T
where T: Copy + Debug,

Source §

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

Source §

fn r_clone(&self) -> T

Create a deep copy of this value.

Source §

#[doc(hidden)]
unsafe extern "C" fn __RClone_r_clone_shim( data: mut c_void, argc: i32, argv: const SEXP, ) -> SEXP
where Self: Sized + RClone + IntoR,

Method shim for RClone::r_clone. Read more

Source §

impl<T> RCopy for T
where T: Copy,

Source §

fn copy(&self) -> T

Create a bitwise copy of this value. Read more

Source §

fn is_copy(&self) -> bool

Check if this type implements Copy. Read more

Source §

#[doc(hidden)]
unsafe extern "C" fn __RCopy_copy_shim( data: mut c_void, argc: i32, argv: const SEXP, ) -> SEXP
where Self: Sized + RCopy + IntoR,

Method shim for RCopy::copy. Read more

Source §

#[doc(hidden)]
unsafe extern "C" fn __RCopy_is_copy_shim( data: mut c_void, argc: i32, argv: const SEXP, ) -> SEXP
where Self: Sized + RCopy + IntoR,

Method shim for RCopy::is_copy. Read more

Source §

impl<T> RDebug for T
where T: Debug,

Source §

fn debug_str(&self) -> String

Get a compact debug string representation.

Source §

fn debug_str_pretty(&self) -> String

Get a pretty-printed debug string with indentation.

Source §

#[doc(hidden)]
unsafe extern "C" fn __RDebug_debug_str_shim( data: mut c_void, argc: i32, argv: const SEXP, ) -> SEXP
where Self: Sized + RDebug,

Method shim for RDebug::debug_str. Read more

Source §

#[doc(hidden)]
unsafe extern "C" fn __RDebug_debug_str_pretty_shim( data: mut c_void, argc: i32, argv: const SEXP, ) -> SEXP
where Self: Sized + RDebug,

Method shim for RDebug::debug_str_pretty. Read more

Source §

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

Source §

default fn lower_bound(&self) -> usize

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

Returns a lower bound on the number of elements this container-like item contains. For example, an array [u8; 12] could return any value between 0 and 12 inclusively as a correct implementation. Read more

Source §

default fn upper_bound(&self) -> Option<usize>

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

Returns an upper bound on the number of elements this container-like item contains if it can be determined, otherwise None. Read more

Source §

final fn size_hint(&self) -> (usize, Option<usize>)

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

Returns an estimate for the number of elements this container like type contains. Read more

Source §