Enum RValue 

pub enum RValue {
    Null,
    Logical(Vec<Option<bool>>),
    Integer(Vec<Option<i32>>),
    Double(Vec<f64>),
    Complex(Vec<Rcomplex>),
    Character(Vec<Option<String>>),
    Raw(Vec<u8>),
    List(Vec<(Option<String>, RValue)>),
}

An owned, Send, R-native value tree. See the module docs.

Variants

Null

NULL (NILSXP).

Logical(Vec<Option<bool>>)

Logical vector (LGLSXP). None is NA.

Integer(Vec<Option<i32>>)

Integer vector (INTSXP). None is NA.

Double(Vec<f64>)

Double vector (REALSXP). NA is carried in the NA_REAL bit pattern.

Complex(Vec<Rcomplex>)

Complex vector (CPLXSXP).

Character(Vec<Option<String>>)

Character vector (STRSXP). None is NA.

Raw(Vec<u8>)

Raw byte vector (RAWSXP). No NA.

List(Vec<(Option<String>, RValue)>)

Generic list (VECSXP). Recursive; a None name is an unnamed slot.

Implementations

impl RValue

pub fn sexptype(&self) -> SEXPTYPE

The SEXPTYPE this value materialises to via IntoR.

pub fn is_null(&self) -> bool

true if this is RValue::Null.

pub fn debug<T: Debug>(value: T) -> Self

Wrap any T: Debug as a length-1 Character carrying its {:?} rendering — the escape hatch for a value with no R-native mapping (e.g. a Rust range). The rendering happens eagerly here, so nothing borrows across the Send boundary a condition payload crosses.

assert_eq!(RValue::debug(0..=100).as_str(), Some("0..=100"));

pub fn as_i32(&self) -> Option<i32>

The single non-NA i32 of a length-1 Integer, else None.

Returns None for the wrong variant, a length other than 1, or NA — the borrow-friendly counterpart to i32::try_from when you don’t need to know why it failed.

pub fn as_f64(&self) -> Option<f64>

The single non-NA f64 of a length-1 Double, else None.

R’s NA (the NA_REAL bit pattern) yields None, matching as_i32.

pub fn as_bool(&self) -> Option<bool>

The single non-NA bool of a length-1 Logical, else None.

pub fn as_str(&self) -> Option<&str>

The single non-NA string of a length-1 Character, else None.

Trait Implementations

impl Clone for RValue

fn clone(&self) -> RValue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RValue

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

Formats the value using the given formatter.

impl From<&str> for RValue

fn from(v: &str) -> Self

Converts to this type from the input type.

impl From<Option<&str>> for RValue

fn from(v: Option<&str>) -> Self

Converts to this type from the input type.

impl From<Option<String>> for RValue

fn from(v: Option<String>) -> Self

Converts to this type from the input type.

impl From<Option<bool>> for RValue

fn from(v: Option<bool>) -> Self

Converts to this type from the input type.

impl From<Option<f64>> for RValue

fn from(v: Option<f64>) -> Self

Converts to this type from the input type.

impl From<Option<i32>> for RValue

fn from(v: Option<i32>) -> Self

Converts to this type from the input type.

impl From<String> for RValue

fn from(v: String) -> Self

Converts to this type from the input type.

impl From<Vec<&str>> for RValue

fn from(v: Vec<&str>) -> Self

Converts to this type from the input type.

impl From<Vec<Option<&str>>> for RValue

fn from(v: Vec<Option<&str>>) -> Self

Converts to this type from the input type.

impl From<Vec<Option<String>>> for RValue

fn from(v: Vec<Option<String>>) -> Self

Converts to this type from the input type.

impl From<Vec<Option<bool>>> for RValue

fn from(v: Vec<Option<bool>>) -> Self

Converts to this type from the input type.

impl From<Vec<Option<f64>>> for RValue

fn from(v: Vec<Option<f64>>) -> Self

Converts to this type from the input type.

impl From<Vec<Option<i32>>> for RValue

fn from(v: Vec<Option<i32>>) -> Self

Converts to this type from the input type.

impl From<Vec<String>> for RValue

fn from(v: Vec<String>) -> Self

Converts to this type from the input type.

impl From<Vec<bool>> for RValue

fn from(v: Vec<bool>) -> Self

Converts to this type from the input type.

impl From<Vec<f64>> for RValue

fn from(v: Vec<f64>) -> Self

Converts to this type from the input type.

impl From<Vec<i32>> for RValue

fn from(v: Vec<i32>) -> Self

Converts to this type from the input type.

impl From<bool> for RValue

fn from(v: bool) -> Self

Converts to this type from the input type.

impl From<f64> for RValue

fn from(v: f64) -> Self

Converts to this type from the input type.

impl From<i32> for RValue

fn from(v: i32) -> Self

Converts to this type from the input type.

impl From<i64> for RValue

Wide-integer ladder: an i64 (or u32) that fits in i32 and is not i32::MIN (R’s NA_integer_) becomes an Integer; anything else becomes a Double. Mirrors R’s own integer→double promotion for out-of-range values.

fn from(v: i64) -> Self

Converts to this type from the input type.

impl From<u32> for RValue

fn from(v: u32) -> Self

Lossless widening to i64, then the shared ladder. A u32 is never i32::MIN as an i32, so only the > i32::MAX case falls to Double.

impl IntoR for RValue

type Error = Infallible

The error type for fallible conversions.

fn try_into_sexp(self) -> Result<SEXP, Self::Error>

Try to convert this value to an R SEXP.

unsafe fn try_into_sexp_unchecked(self) -> Result<SEXP, Self::Error>

Try to convert to SEXP without thread safety checks.

fn into_sexp(self) -> SEXP

Convert this value to an R SEXP, panicking on error.

unsafe fn into_sexp_unchecked(self) -> SEXP

where Self: Sized,

Convert to SEXP without thread safety checks, panicking on error.

impl TryFrom<RValue> for i32

type Error = SexpError

The type returned in the event of a conversion error.

fn try_from(value: RValue) -> Result<Self, SexpError>

Performs the conversion.

impl TryFrom<RValue> for bool

type Error = SexpError

The type returned in the event of a conversion error.

fn try_from(value: RValue) -> Result<Self, SexpError>

Performs the conversion.

impl TryFrom<RValue> for String

type Error = SexpError

The type returned in the event of a conversion error.

fn try_from(value: RValue) -> Result<Self, SexpError>

Performs the conversion.

impl TryFrom<RValue> for f64

type Error = SexpError

The type returned in the event of a conversion error.

fn try_from(value: RValue) -> Result<Self, SexpError>

Performs the conversion.

impl TryFrom<RValue> for Vec<Option<bool>>

type Error = SexpError

The type returned in the event of a conversion error.

fn try_from(value: RValue) -> Result<Self, SexpError>

Performs the conversion.

impl TryFrom<RValue> for Vec<Option<i32>>

type Error = SexpError

The type returned in the event of a conversion error.

fn try_from(value: RValue) -> Result<Self, SexpError>

Performs the conversion.

impl TryFrom<RValue> for Vec<f64>

type Error = SexpError

The type returned in the event of a conversion error.

fn try_from(value: RValue) -> Result<Self, SexpError>

Performs the conversion.

impl TryFrom<RValue> for Vec<Rcomplex>

type Error = SexpError

The type returned in the event of a conversion error.

fn try_from(value: RValue) -> Result<Self, SexpError>

Performs the conversion.

impl TryFrom<RValue> for Vec<Option<String>>

type Error = SexpError

The type returned in the event of a conversion error.

fn try_from(value: RValue) -> Result<Self, SexpError>

Performs the conversion.

impl TryFrom<RValue> for Vec<u8>

type Error = SexpError

The type returned in the event of a conversion error.

fn try_from(value: RValue) -> Result<Self, SexpError>

Performs the conversion.

impl TryFrom<RValue> for Vec<(Option<String>, RValue)>

type Error = SexpError

The type returned in the event of a conversion error.

fn try_from(value: RValue) -> Result<Self, SexpError>

Performs the conversion.

impl TryFromSexp for RValue

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.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 32 bytes

Size for each variant:

• Null: 0 bytes
• Logical: 24 bytes
• Integer: 24 bytes
• Double: 24 bytes
• Complex: 24 bytes
• Character: 24 bytes
• Raw: 24 bytes
• List: 24 bytes