Struct Read 

pub struct Read<'a> {
    pub sources: &'a [Binding<'a>],
    pub plan: &'a ReadPlan,
}

Sources are bound at execution; plans never retain their data.

Fields

sources: &'a [Binding<'a>]

plan: &'a ReadPlan

Implementations

impl<'s> Read<'s>

pub fn positional(&self, shape: &[usize]) -> Option<(View<'_>, Mapping)>

pub fn part_view<'a>( &'a self, range: Range<usize>, dtype: DType, checked: bool, scratch: &'a mut Buffer, ) -> Result<View<'a>, Error>

Borrows a contiguous input range; other reads use scratch at exactly the requested length.

pub fn argument<'a>( self, range: Range<usize>, checked: bool, scratch: &'a mut Buffer, ) -> Result<(View<'a>, usize), Error>

where 's: 'a,

A span at its actual storage dtype and the item count copied. Copied spans require sources of one dtype.

pub fn borrowed<T>( &self, range: Range<usize>, checked: bool, ) -> Result<Option<Arg<'s, T>>, Error>

where T: Cast,

A typed span borrowed from storage, or one scalar converted once; None means array materialization is needed.

pub fn part<'a, T>( &'a self, range: Range<usize>, checked: bool, scratch: &'a mut Vec<T>, ) -> Result<Arg<'a, T>, Error>

where T: Cast,

pub fn part_counted<'a, T>( &'a self, range: Range<usize>, checked: bool, scratch: &'a mut Vec<T>, ) -> Result<(Arg<'a, T>, usize), Error>

where T: Cast,

The same read and the number of items it materialized in scratch; borrowed runs and scalar conversions count zero.

pub fn in_place<T>(&self, range: &Range<usize>) -> bool

where T: Cast,

Whether part reads range in place, writing no scratch: one run of a source that holds T, or one item that every position reads.

pub fn rows<T>(&self, shape: [usize; 2]) -> Option<Rows<'s, T>>

where T: Cast,

This read as rows over a result of shape, which is rows then items, where every source is bound as the plan reads it, the plan maps one source that holds T affinely over shape, and each row reads one item or a run of items. None for any other read.

pub fn mapped_source(&self) -> Option<(View<'s>, &'s Mapping)>

The whole source and the mapping of a read that maps one source with no fills, for a reader that walks the mapping itself (linalg::Mapped).

pub fn read_into( &self, range: Range<usize>, dtype: DType, checked: bool, output: &mut Buffer, ) -> Result<(), Error>

Trait Implementations

impl<'a> Clone for Read<'a>

fn clone(&self) -> Read<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for Read<'a>