Struct VmRange 

pub struct VmRange {
    pub start: i64,
    pub end: i64,
    pub inclusive: bool,
}

A lazy integer range — Python-style. Stores only (start, end, inclusive) so the in-memory footprint is O(1) regardless of the range’s length. len(), indexing (r[k]), .contains(x), .first(), .last() are all O(1); direct iteration walks step-by-step without materializing a list.

Empty-range convention (Python-consistent):

• Inclusive empty when start > end.
• Exclusive empty when start >= end.

Negative / reversed ranges are NOT supported in v1: 5 to 1 is simply empty. Authors who want reverse iteration should call .to_list().reverse().

Fields

start: i64

end: i64

inclusive: bool

Implementations

impl VmRange

pub fn len(&self) -> i64

Number of elements this range yields.

Uses saturating arithmetic so that pathological ranges near i64::MAX/i64::MIN do not panic on overflow. Because a range’s element count must fit in i64 the returned length saturates at i64::MAX for ranges whose width exceeds that (e.g. i64::MIN to i64::MAX inclusive). Callers that later narrow to usize for allocation should still guard against huge lengths — see to_vec / get for the indexable-range invariants.

pub fn is_empty(&self) -> bool

pub fn get(&self, idx: i64) -> Option<i64>

Element at the given 0-based index, bounds-checked. Returns None when out of bounds or when start + idx would overflow (which can only happen when len() saturated).

pub fn first(&self) -> Option<i64>

First element or None when empty.

pub fn last(&self) -> Option<i64>

Last element or None when empty.

pub fn contains(&self, v: i64) -> bool

Whether v falls inside the range (O(1)).

pub fn to_vec(&self) -> Vec<VmValue>

Materialize to a Vec<VmValue> — the explicit escape hatch.

Uses checked_add on the per-element index so a range near i64::MAX stops at the representable bound instead of panicking. Callers should still treat a very long range as unwise to materialize (the whole point of VmRange is to avoid this).

Trait Implementations

impl Clone for VmRange

fn clone(&self) -> VmRange

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VmRange

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

Formats the value using the given formatter.

impl Copy for VmRange