Enum VmIter 

pub enum VmIter {
    Range {
        next: i64,
        stop: i64,
    },
    Vec {
        items: Rc<Vec<VmValue>>,
        idx: usize,
    },
    Dict {
        entries: Rc<BTreeMap<String, VmValue>>,
        keys: Vec<String>,
        idx: usize,
    },
    Chars {
        s: Rc<str>,
        byte_idx: usize,
    },
    Gen {
        gen: VmGenerator,
    },
    Chan {
        handle: VmChannelHandle,
    },
    Map {
        inner: Rc<RefCell<VmIter>>,
        f: VmValue,
    },
    Filter {
        inner: Rc<RefCell<VmIter>>,
        p: VmValue,
    },
    FlatMap {
        inner: Rc<RefCell<VmIter>>,
        f: VmValue,
        cur: Option<Rc<RefCell<VmIter>>>,
    },
    Take {
        inner: Rc<RefCell<VmIter>>,
        remaining: usize,
    },
    Skip {
        inner: Rc<RefCell<VmIter>>,
        remaining: usize,
    },
    TakeWhile {
        inner: Rc<RefCell<VmIter>>,
        p: VmValue,
        done: bool,
    },
    SkipWhile {
        inner: Rc<RefCell<VmIter>>,
        p: VmValue,
        primed: bool,
    },
    Zip {
        a: Rc<RefCell<VmIter>>,
        b: Rc<RefCell<VmIter>>,
    },
    Enumerate {
        inner: Rc<RefCell<VmIter>>,
        i: i64,
    },
    Chain {
        a: Rc<RefCell<VmIter>>,
        b: Rc<RefCell<VmIter>>,
        on_a: bool,
    },
    Chunks {
        inner: Rc<RefCell<VmIter>>,
        n: usize,
    },
    Windows {
        inner: Rc<RefCell<VmIter>>,
        n: usize,
        buf: VecDeque<VmValue>,
    },
    Exhausted,
}

Backing enum for VmValue::Iter. See module docs.

Variants

Range

Step through a lazy integer range without materializing. next is the value to emit on the next call; stop is the first value that terminates the iteration (one past the end).

Fields

next: i64

stop: i64

Vec

Snapshot over a shared list / set backing store.

Fields

items: Rc<Vec<VmValue>>

idx: usize

Dict

Snapshot over a dict; yields one-key {key, value} dicts for now. Step (b) swaps these for VmValue::Pair when the Pair variant lands.

Fields

entries: Rc<BTreeMap<String, VmValue>>

keys: Vec<String>

idx: usize

Chars

Unicode scalar iteration over a string.

Fields

s: Rc<str>

byte_idx: usize

Gen

Drains a generator’s yield channel.

Fields

gen: VmGenerator

Chan

Reads from a channel handle.

Fields

handle: VmChannelHandle

Map

Maps each item through a closure.

Fields

inner: Rc<RefCell<VmIter>>

f: VmValue

Filter

Keeps only items for which the predicate is truthy.

Fields

inner: Rc<RefCell<VmIter>>

p: VmValue

FlatMap

Maps each item to an iterable and flattens one level.

Fields

inner: Rc<RefCell<VmIter>>

f: VmValue

cur: Option<Rc<RefCell<VmIter>>>

Take

Yields up to remaining items from inner, then becomes Exhausted.

Fields

inner: Rc<RefCell<VmIter>>

remaining: usize

Skip

Skips the first remaining items from inner on the first call, then forwards. remaining == 0 is the sentinel for “already primed”.

Fields

inner: Rc<RefCell<VmIter>>

remaining: usize

TakeWhile

Yields items from inner while the predicate is truthy; after the first falsy predicate or inner exhaustion, becomes Exhausted.

Fields

inner: Rc<RefCell<VmIter>>

p: VmValue

done: bool

SkipWhile

Discards items while the predicate is truthy; after the first falsy item, forwards that item and all subsequent items from inner.

Fields

inner: Rc<RefCell<VmIter>>

p: VmValue

primed: bool

Zip

Advances two inner iters in lockstep; yields Pair(a, b) until either side is exhausted.

Fields

a: Rc<RefCell<VmIter>>

b: Rc<RefCell<VmIter>>

Enumerate

Yields Pair(i, item) starting at i = 0.

Fields

inner: Rc<RefCell<VmIter>>

i: i64

Chain

Concatenates two iters: drains a first, then b.

Fields

a: Rc<RefCell<VmIter>>

b: Rc<RefCell<VmIter>>

on_a: bool

Chunks

Yields VmValue::List batches of up to n items from inner. The final batch may be shorter; empty input yields no batches.

Fields

inner: Rc<RefCell<VmIter>>

n: usize

Windows

Yields sliding windows of exactly n items from inner as VmValue::List. If the input has fewer than n items total, no windows are yielded.

Fields

inner: Rc<RefCell<VmIter>>

n: usize

buf: VecDeque<VmValue>

Exhausted

Terminal state: next always returns None.

Implementations

impl VmIter

pub fn next<'a>( &'a mut self, vm: &'a mut Vm, ) -> Pin<Box<dyn Future<Output = Result<Option<VmValue>, VmError>> + 'a>>

Produce the next value, or None when exhausted.

Combinator variants (Map, Filter, FlatMap) invoke user-provided closures through the vm parameter.

Trait Implementations

impl Debug for VmIter

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

Formats the value using the given formatter.