Struct ArrayData 

pub struct ArrayData {
    pub metadata: ArrayMetadata,
    pub values: ArrayValues,
}

A block of numbers, as read, with the shape it came in.

How many copies

Reading a compressed or chunked dataset cannot be done without the library materialising it somewhere, so one copy - from the file into the caller’s memory - is the floor. What this type is shaped to avoid is the second and third:

ArrayData::values	filled straight by the backend. One copy
ArrayValues::as_bytes	a borrow of that same memory. Zero
ArrayData::f64 and friends	a borrow when the type already matches. Zero
ArrayData::to_f64	widens every element. One more copy, and you asked for it

And crate::ArrayBackend::read_into removes even the first allocation: the caller supplies the buffer - a vertex buffer, a memory-mapped region - and the file is decoded straight into it.

Fields

metadata: ArrayMetadata

Shape of what was read.

values: ArrayValues

The values, in the file’s own element type.

Implementations

impl ArrayData

pub fn element_count(&self) -> usize

How many elements the shape promises.

pub fn as_bytes(&self) -> &[u8]

The block as bytes, borrowed. No copy.

pub fn f64(&self) -> Option<&[f64]>

The values as f64, borrowed, when that is what the file holds.

The path a 3D application takes for coordinates: no conversion, no allocation, just the numbers.

pub fn f32(&self) -> Option<&[f32]>

The values as f32, borrowed, when that is what the file holds.

pub fn i64(&self) -> Option<&[i64]>

The values as i64, borrowed, when that is what the file holds.

pub fn u32(&self) -> Option<&[u32]>

The values as u32, borrowed, when that is what the file holds - what RESQML uses for indices.

pub fn to_f64(&self) -> Vec<f64>

Every element widened to f64.

This copies, and it is the only method here that does. Use ArrayData::f64 when the file already holds doubles, which for coordinates it does.

Trait Implementations

impl Clone for ArrayData

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ArrayData

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

Formats the value using the given formatter.

impl PartialEq for ArrayData

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ArrayData