Struct ParcodeCollectionPromise 

pub struct ParcodeCollectionPromise<'a, T> { /* private fields */ }

A promise for a collection (Vector).

Supports partial loading and random access via .get(index). Specialized lazy field for collections (Vec) allowing partial access.

Implementations

impl<'a, T: ParcodeItem + Send + Sync + 'a> ParcodeCollectionPromise<'a, T>

pub fn new(node: ChunkNode<'a>) -> Self

Internal constructor.

pub fn load(&self) -> Result<Vec<T>>

Loads the entire collection into memory.

pub fn get(&self, index: usize) -> Result<T>

Retrieves a single item without loading the whole collection. Uses O(1) arithmetic navigation.

pub fn len(&self) -> usize

Returns the number of items in the collection.

This is an O(1) operation that reads the length from the chunk header.

pub fn is_empty(&self) -> bool

Returns true if the collection has no items.

pub fn iter(&self) -> Result<impl Iterator<Item = Result<T>> + 'a>

Returns a streaming iterator.

impl<'a, T> ParcodeCollectionPromise<'a, T>

where T: ParcodeItem + Send + Sync + ParcodeLazyRef<'a> + 'a,

pub fn get_lazy(&self, index: usize) -> Result<T::Lazy>

Retrieves a Lazy Proxy for the item at index.

This allows accessing local fields of the item without triggering the loading of its heavy dependencies.

pub fn first(&self) -> Result<Option<T::Lazy>>

Returns the first item as a lazy mirror, or None if empty.

pub fn last(&self) -> Result<Option<T::Lazy>>

Returns the last item as a lazy mirror, or None if empty.

pub fn iter_lazy(&self) -> Result<ParcodeLazyIterator<'a, T>>

Returns a lazy streaming iterator over the collection.

This is highly efficient: it loads shards sequentially and processes items without re-reading bytes. Ideal for scanning large datasets.

Trait Implementations

impl<'a, T: Clone> Clone for ParcodeCollectionPromise<'a, T>

fn clone(&self) -> ParcodeCollectionPromise<'a, T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a, T: Debug> Debug for ParcodeCollectionPromise<'a, T>

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

Formats the value using the given formatter.