Struct AsNumericVec 

pub struct AsNumericVec(pub Vec<Option<f64>>);

A numeric vector read like R’s as.numeric(): from a double, integer, logical, character, or factor (by its labels) vector. NA of any type is None.

Data read from CSV files or spreadsheets often arrives as character, with numbers mixed with tokens such as "n/a" or "<0.1", or as a factor whose labels are the numbers. This marker takes any of those, maps every kind of NA to None, and names the values that are not numbers in one error.

Reading rules

R input	Result
double	as is; NA_real_ → None, NaN stays Some(NaN)
integer, logical	widened to f64; NA → None
character	parsed as as.numeric() does (see below)
factor	each label (levels(x)[x]) parsed as character, never the codes; code NA → None
anything else (list, raw, complex, …)	SexpError::Type

Character parsing follows R’s String2Real (RealFromString in src/main/coerce.c):

• NA_character_ → None.
• A blank string (empty, or whitespace only) → None, as as.numeric("") gives NA without a warning.
• The token "NA", with blanks around it at most, → None. This follows scan() / type.convert(), which read "NA" as missing; as.numeric("NA") also gives NA, but with a coercion warning.
• Otherwise R’s own R_strtod reads a number, and the rest of the string must be blank. That accepts surrounding spaces, "Inf", "-inf", "Infinity", "NaN", "1e3", "+.5", "5.", and hex such as "0x1A" or "0x1p3", exactly as the running R does.
• Anything else fails. All failures are collected and reported together: non-numeric value(s): "n/a", "<0.1" (elements 2, 5), with 1-based element numbers and at most 10 values listed (the rest as "; and N more").

no_na

#[miniextendr(no_na)] refuses everything this marker reads as missing, not only what R’s anyNA() sees: the R guard refuses NA (and a numeric NaN) before the call, and the C wrapper checks the converted value after it, refusing None (the token "NA", blank strings, factor labels among those) and NaN (from the text "NaN" too). Both raise the same 'x' must not contain NA argument error. NULL given to an Option<AsNumericVec> is still None, as not given. A type alias or a #[derive(TryFromSexp)] newtype of the marker is checked the same way.

Option<AsNumericVec> (and Option<AsNumeric>) also accept NULL as None.

IntoR

The markers convert to R as their inner Vec<Option<f64>> / Option<f64>: a double vector with NA for None, which the marker reads back unchanged (NaN stays Some(NaN), though a NaN carrying R’s NA payload reads back as None, as R_IsNA says), and Option<marker> gives NULL for None. That is what lets a #[miniextendr] trait method take a marker parameter: the trait’s View converts each argument with IntoR and the implementing side reads it back with TryFromSexp. A #[miniextendr] function returning a marker gives the same R value as returning .0; returning .0 stays the idiom.

Example

use miniextendr_api::{miniextendr, AsNumericVec};

#[miniextendr]
fn total(x: AsNumericVec) -> f64 {
    x.0.into_iter().flatten().sum()
}
// R: total(c(" 1.5 ", "NA", "", "0x10")) → 17.5
//    total(factor(c("10", "2")))         → 12  (labels, not codes)
//    total(c("1", "n/a", "3", "4", "<0.1"))
//    → error: non-numeric value(s): "n/a", "<0.1" (elements 2, 5)

Tuple Fields

0: Vec<Option<f64>>

Trait Implementations

impl Clone for AsNumericVec

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AsNumericVec

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

Formats the value using the given formatter.

impl Default for AsNumericVec

fn default() -> Self

Returns the “default value” for a type.

impl IntoR for AsNumericVec

type Error = <Vec<Option<f64>> as IntoR>::Error

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

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

impl PartialEq for AsNumericVec

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for AsNumericVec

impl TryFromSexp for AsNumericVec

type Error = SexpError

The error type returned when conversion fails.

fn __mx_has_na(&self) -> bool

Whether the converted argument holds a value #[miniextendr(no_na)] refuses after the conversion.

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

Attempt to convert an R SEXP to this Rust type.

const NATIVE_BORROW: Option<NativeBorrow> = None

Native vector storage retained by this conversion, if any.

const CHARACTER_ONLY: bool = false

Whether this conversion accepts only character input: every value it converts, other than NULL, is a character vector or a factor.

#[doc(hidden)]

const __MX_EXPECTATION: Option<&'static str> = None

What an argument of this type must be, in R terms, when #[miniextendr] cannot tell from the type as written: the <expected> of a failed conversion’s '<p>' must be <expected>: ....

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

Convert from SEXP without thread safety checks.

#[doc(hidden)]

unsafe fn __mx_try_from_rooted(root: Root<'_>) -> Result<Self, Self::Error>

Convert with a scope able to retain uncached ALTREP elements. Custom reference converters keep their existing behavior by default.

#[doc(hidden)]

fn __mx_input_has_na(&self, input: SEXP) -> bool

Whether #[miniextendr(no_na)] refuses this converted argument, read from input (the R value it converted from), when no R guard ran.

#[doc(hidden)]

fn __mx_try_from_sexp_with_check( sexp: SEXP, check: &ElementCheck<'_>, ) -> Result<Self, SexpError>

where Self::Error: Into<SexpError>,

Convert, running check, an element type’s TryFromSexpElement::check_sexp, on the R value that carries an element’s class (#1837).

#[doc(hidden)]

unsafe fn __mx_try_from_sexp_unchecked_with_check( sexp: SEXP, check: &ElementCheck<'_>, ) -> Result<Self, SexpError>

where Self::Error: Into<SexpError>,

__mx_try_from_sexp_with_check through try_from_sexp_unchecked. Not public API.

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: 24 bytes