miniextendr_api::altrep_data::iter::coerce

Struct IterListData

pub struct IterListData<I>where
    I: Iterator<Item = SEXP>,{
    state: IterState<I, SEXP>,
}

Expand description

Iterator-backed list vector data adaptor.

Wraps an iterator producing R SEXP values and implements the data-level traits (AltrepLen + AltListData) for backing an ALTREP list. To expose it to R, wrap it in a #[derive(AltrepList)] + #[altrep(manual)] struct (see the module docs).

§Safety

The iterator must produce valid, protected SEXP values. Each SEXP must remain protected for the lifetime of the ALTREP object.

§Example

use miniextendr_api::altrep_data::IterListData;
use miniextendr_api::IntoR;

let iter = (0..5).map(|x| vec![x, x+1, x+2].into_sexp());
let data = IterListData::from_iter(iter, 5);

Fields§

§state: IterState<I, SEXP>

Implementations§

Source §

impl IterListData
where I: Iterator<Item = SEXP>,

Source

pub fn from_iter(iter: I, len: usize) -> Self

Create from an iterator with explicit length.

§Safety

The iterator must produce valid, protected SEXP values.

Source §

impl IterListData
where I: ExactSizeIterator<Item = SEXP>,

Source

pub fn from_exact_iter(iter: I) -> Self

Create from an ExactSizeIterator (length auto-detected).

§Safety

The iterator must produce valid, protected SEXP values.

Trait Implementations§

Source §

impl AltListData for IterListData
where I: Iterator<Item = SEXP>,

Source §

fn elt(&self, i: usize) -> SEXP

Get the list element at index i. Read more

Source §

impl AltrepLen for IterListData
where I: Iterator<Item = SEXP>,

Source §

fn len(&self) -> usize

Returns the length of this ALTREP vector.

Source §

fn is_empty(&self) -> bool

Returns true if the vector is empty.

Auto Trait Implementations§

§

impl UnwindSafe for IterListData
where I: UnwindSafe,

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> 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> 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 §