Struct IterListData 

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

Iterator-backed list vector.

Wraps an iterator producing R SEXP values and exposes it as an ALTREP list.

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

impl<I> IterListData<I>

where I: Iterator<Item = SEXP>,

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.

impl<I> IterListData<I>

where I: ExactSizeIterator<Item = SEXP>,

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

impl<I: Iterator<Item = SEXP> + 'static> AltList for IterListData<I>

fn elt(x: SEXP, i: R_xlen_t) -> SEXP

Get list element at index. Returns any SEXP. This is REQUIRED for ALTLIST - there is no default.

const HAS_SET_ELT: bool = false

Set to true to register set_elt.

fn set_elt(_x: SEXP, _i: R_xlen_t, _v: SEXP)

Set element (for mutable lists).

impl<I> AltListData for IterListData<I>

where I: Iterator<Item = SEXP>,

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

Get the list element at index i.

impl<I: Iterator<Item = SEXP> + 'static> AltVec for IterListData<I>

const HAS_DATAPTR: bool = false

Set to true to register dataptr.

fn dataptr(_x: SEXP, _writable: bool) -> *mut c_void

Get raw data pointer.

const HAS_DATAPTR_OR_NULL: bool = false

Set to true to register dataptr_or_null.

fn dataptr_or_null(_x: SEXP) -> *const c_void

Get data pointer without forcing materialization.

const HAS_EXTRACT_SUBSET: bool = false

Set to true to register extract_subset.

fn extract_subset(_x: SEXP, _indx: SEXP, _call: SEXP) -> SEXP

Optimized subsetting.

impl<I: Iterator<Item = SEXP> + 'static> Altrep for IterListData<I>

fn length(x: SEXP) -> R_xlen_t

Returns the length of the ALTREP vector. This is REQUIRED - R cannot determine vector length without it.

const GUARD: AltrepGuard = AltrepGuard::RUnwind

The guard mode for all ALTREP trampolines on this type.

const HAS_SERIALIZED_STATE: bool = false

Set to true to register serialized_state.

fn serialized_state(_x: SEXP) -> SEXP

Return serialization state.

const HAS_UNSERIALIZE: bool = false

Set to true to register unserialize.

fn unserialize(_class: SEXP, _state: SEXP) -> SEXP

Reconstruct ALTREP from serialized state.

const HAS_UNSERIALIZE_EX: bool = false

Set to true to register unserialize_ex.

fn unserialize_ex( _class: SEXP, _state: SEXP, _attr: SEXP, _objf: i32, _levs: i32, ) -> SEXP

Extended unserialization with attributes.

const HAS_DUPLICATE: bool = false

Set to true to register duplicate.

fn duplicate(_x: SEXP, _deep: bool) -> SEXP

Duplicate the ALTREP object.

const HAS_DUPLICATE_EX: bool = false

Set to true to register duplicate_ex.

fn duplicate_ex(_x: SEXP, _deep: bool) -> SEXP

Extended duplication.

const HAS_COERCE: bool = false

Set to true to register coerce.

fn coerce(_x: SEXP, _to_type: SEXPTYPE) -> SEXP

Coerce to another type.

const HAS_INSPECT: bool = false

Set to true to register inspect.

fn inspect( _x: SEXP, _pre: i32, _deep: i32, _pvec: i32, _inspect_subtree: Option<unsafe extern "C-unwind" fn(SEXP, i32, i32, i32)>, ) -> bool

Custom inspection for .Internal(inspect()).

impl<I> AltrepLen for IterListData<I>

where I: Iterator<Item = SEXP>,

fn len(&self) -> usize

Returns the length of this ALTREP vector.

fn is_empty(&self) -> bool

Returns true if the vector is empty.

impl<I: Iterator<Item = SEXP> + 'static> InferBase for IterListData<I>

const BASE: RBase = crate::altrep::RBase::List

The inferred R base type.

unsafe fn make_class( class_name: *const i8, pkg_name: *const i8, ) -> R_altrep_class_t

Create the ALTREP class handle.

unsafe fn install_methods(cls: R_altrep_class_t)

Install ALTREP methods on the class.

impl<I: Iterator<Item = SEXP> + 'static> TypedExternal for IterListData<I>

const TYPE_NAME: &'static str = "IterListData"

The type name as a static string (for debugging and display)

const TYPE_NAME_CSTR: &'static [u8] = b"IterListData\0"

The type name as a null-terminated C string (for R tag display)

const TYPE_ID_CSTR: &'static [u8] = b"miniextendr_api::altrep::IterListData\0"

Namespaced type ID as a null-terminated C string (for type checking).