Struct Coerced 

#[repr(transparent)]
pub struct Coerced<T, R> {
    value: T,
    _marker: PhantomData<R>,
}

Wrapper for values coerced from an R native type during conversion.

This enables using non-native Rust types in collections read from R:

// Read a Vec of i64 from R integers (i32)
let vec: Vec<Coerced<i64, i32>> = TryFromSexp::try_from_sexp(sexp)?;

// Extract the values
let i64_vec: Vec<i64> = vec.into_iter().map(Coerced::into_inner).collect();

The type parameters are:

• T: The target Rust type you want
• R: The R-native type to read and coerce from

Fields

value: T

_marker: PhantomData<R>

Implementations

impl<T, R> Coerced<T, R>

pub const fn new(value: T) -> Self

Create a new Coerced wrapper.

pub fn into_inner(self) -> T

Extract the inner value.

pub const fn as_inner(&self) -> &T

Get a reference to the inner value.

pub fn as_inner_mut(&mut self) -> &mut T

Get a mutable reference to the inner value.

Trait Implementations

impl<T: Clone, R: Clone> Clone for Coerced<T, R>

fn clone(&self) -> Coerced<T, R>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug, R: Debug> Debug for Coerced<T, R>

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

Formats the value using the given formatter.

impl<T: Default, R: Default> Default for Coerced<T, R>

fn default() -> Coerced<T, R>

Returns the “default value” for a type.

impl<T, R> Deref for Coerced<T, R>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T, R> DerefMut for Coerced<T, R>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<T: Eq, R: Eq> Eq for Coerced<T, R>

#[doc(hidden)]

fn assert_fields_are_eq(&self)

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

#[doc(hidden)]

fn assert_receiver_is_total_eq(&self)

👎Deprecated since 1.95.0:

implementation detail of #[derive(Eq)]

impl<T: Hash, R: Hash> Hash for Coerced<T, R>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: Ord, R: Ord> Ord for Coerced<T, R>

fn cmp(&self, other: &Coerced<T, R>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<T: PartialEq, R: PartialEq> PartialEq for Coerced<T, R>

fn eq(&self, other: &Coerced<T, R>) -> bool

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

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

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

impl<T: PartialOrd, R: PartialOrd> PartialOrd for Coerced<T, R>

fn partial_cmp(&self, other: &Coerced<T, R>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

#[doc(hidden)]

fn __chaining_lt(&self, other: &Rhs) -> ControlFlow<bool>

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

If self == other, returns ControlFlow::Continue(()). Otherwise, returns ControlFlow::Break(self < other).

#[doc(hidden)]

fn __chaining_le(&self, other: &Rhs) -> ControlFlow<bool>

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

Same as __chaining_lt, but for <= instead of <.

#[doc(hidden)]

fn __chaining_gt(&self, other: &Rhs) -> ControlFlow<bool>

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

Same as __chaining_lt, but for > instead of <.

#[doc(hidden)]

fn __chaining_ge(&self, other: &Rhs) -> ControlFlow<bool>

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

Same as __chaining_lt, but for >= instead of <.

impl<T, R> TryFromSexp for Coerced<T, R>

where R: TryFromSexp + TryCoerce<T>, <R as TryFromSexp>::Error: Into<SexpError>, <R as TryCoerce<T>>::Error: Debug,

Convert R value to Coerced<T, R> by reading R and coercing to T.

This enables reading non-native Rust types from R with coercion:

// Read i64 from R integer (i32)
let val: Coerced<i64, i32> = TryFromSexp::try_from_sexp(sexp)?;
let i64_val: i64 = val.into_inner();

// Works with collections too:
let vec: Vec<Coerced<i64, i32>> = ...;
let set: HashSet<Coerced<NonZeroU32, i32>> = ...;

type Error = SexpError

The error type returned when conversion fails.

fn try_from_sexp(sexp: SEXP) -> Result<Self, Self::Error>

Attempt to convert an R SEXP to this Rust type.

unsafe fn try_from_sexp_unchecked(sexp: SEXP) -> Result<Self, Self::Error>

Convert from SEXP without thread safety checks.

impl<T: Copy, R: Copy> Copy for Coerced<T, R>

impl<T, R> StructuralPartialEq for Coerced<T, R>

Layout

Note: Unable to compute type layout, possibly due to this type having generic parameters. Layout can only be computed for concrete, fully-instantiated types.