Struct NumericArrayV 

pub struct NumericArrayV {
    pub array: NumericArray,
    pub offset: usize,
    /* private fields */
}

NumericArrayView

Read-only, zero-copy view over a [offset .. offset + len) window of a NumericArray.

Purpose

• Return an indexable subrange without cloning buffers.
• Optionally cache per-window null counts for faster repeated passes.

Behaviour

• Groups integer and float variants under one enum.
• Upcasts via get_f64 for uniform handling.
• Further slicing yields another borrowed view.

Fields

• array: backing NumericArray (enum over numeric types).
• offset: starting index into the backing array.
• len: logical number of elements in the view.
• null_count: cached Option<usize> for this window (internal).

Notes

• Not thread-safe due to Cell. Create per-thread views with slice.
• Use to_numeric_array to materialise the window.

Fields

array: NumericArray

offset: usize

Implementations

impl NumericArrayV

pub fn new(array: NumericArray, offset: usize, len: usize) -> Self

Creates a new NumericArrayView with the given offset and length.

pub fn new_nc( array: NumericArray, offset: usize, len: usize, null_count: usize, ) -> Self

Creates a new NumericArrayView with a precomputed null count.

pub fn is_empty(&self) -> bool

Returns true if the view is empty.

pub fn inner_array(&self) -> Array

Returns the full backing array wrapped as an Array enum, ignoring the view’s offset and length.

Use this to access inner array methods. The returned array is the unwindowed original.

pub fn get_f64(&self, i: usize) -> Option<f64>

Returns the value at logical index i as f64, or None if out of bounds or null.

Converts any numeric types to f64, simplifying usage by avoiding explicit enum matches in caller code.

Notes

• Returns None if i is out of bounds or the value is null.
• Upcasts integer and float types to f64 for uniform downstream handling.

pub unsafe fn get_f64_unchecked(&self, i: usize) -> Option<f64>

Unchecked, returns None for nulls, skips bounds check.

Converts any numeric types to f64, simplifying usage by avoiding explicit enum matches in caller code.

pub fn slice(&self, offset: usize, len: usize) -> Self

Returns a windowed view into a sub-range of this view.

pub fn to_numeric_array(&self) -> NumericArray

Materialise as an owned NumericArray for the window.

If the view covers the entire backing array, returns a cheap Arc clone of the original variant. Otherwise deep-copies the window via slice_clone through inner_array.

pub fn end(&self) -> usize

Returns the end index of the view.

pub fn as_tuple(&self) -> (NumericArray, usize, usize)

Returns the view as a tuple (array, offset, len).

Note: This clones the Arc-wrapped NumericArray.

pub fn as_tuple_ref(&self) -> (&NumericArray, usize, usize)

Returns a reference tuple: (&NumericArray, offset, len).

This avoids cloning the Arc and returns a reference with a lifetime tied to this NumericArrayV.

pub fn len(&self) -> usize

Returns the length of the window

pub fn null_count(&self) -> usize

Returns the number of nulls in the view.

pub fn has_nulls(&self) -> bool

Returns true when the windowed view holds at least one null.

Reads through null_count, so the cached value is trusted when set and the full popcount is only paid on the first call that observes this view.

pub fn null_mask_view(&self) -> Option<BitmaskV>

Returns the null mask as a windowed BitmaskView.

pub fn set_null_count(&self, count: usize) -> Result<(), usize>

Sets the cached null count for the view.

Returns Ok(()) if the value was set, or Err(count) if it was already initialised. This is thread-safe and can only succeed once per NumericArrayV instance.

pub fn guarantee_f64(&mut self) -> (&[f64], Option<&Bitmask>, Option<usize>)

Guarantees the backing array is Float64, then returns the f64 slice, null mask, and null count for this view’s window.

If already Float64, this is a pass-through. Otherwise the full backing NumericArray is cast to Float64 via NumericArray::cow_into_f64, preserving the window offset and length.

When multiple views share the same backing array, the first view to call this will trigger the cast. If it holds the sole Arc reference, the old data is consumed in place. If other references exist, the data is cloned, leaving the shared original untouched. Subsequent views that still reference the original will cast independently when they reach this call, so it generally is best avoided in such contexts as it would clone for every independent window view.

Trait Implementations

impl Clone for NumericArrayV

fn clone(&self) -> NumericArrayV

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Concatenate for NumericArrayV

fn concat(self, other: Self) -> Result<Self, MinarrowError>

Concatenates two numeric array views by materialising both to owned numeric arrays, concatenating them, and wrapping the result back in a view.

Notes

• This operation copies data from both views to create owned numeric arrays.
• The resulting view has offset=0 and length equal to the combined length.

impl Debug for NumericArrayV

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

Formats the value using the given formatter.

impl Display for NumericArrayV

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

Formats the value using the given formatter.

impl From<Array> for NumericArrayV

fn from(array: Array) -> Self

Converts to this type from the input type.

impl From<ArrayV> for NumericArrayV

fn from(view: ArrayV) -> Self

Converts to this type from the input type.

impl From<FieldArray> for NumericArrayV

fn from(field_array: FieldArray) -> Self

Converts to this type from the input type.

impl From<NumericArray> for NumericArrayV

fn from(array: NumericArray) -> Self

Converts to this type from the input type.

impl From<NumericArrayV> for Value

Available on crate feature views only.

Wrap a NumericArrayV as Value::ArrayView. The view’s offset and length are preserved; the inner NumericArray flows through Array::NumericArray.

fn from(v: NumericArrayV) -> Self

Converts to this type from the input type.

impl From<NumericArrayV> for ArrayV

Available on crate feature views only.

NumericArrayView -> ArrayView

Converts by wrapping the inner NumericArray as Array::NumericArray.

fn from(view: NumericArrayV) -> Self

Converts to this type from the input type.

impl PartialEq for NumericArrayV

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Shape for NumericArrayV

fn shape(&self) -> ShapeDim

Returns arbitrary Shape dimension for any data shape

fn shape_1d(&self) -> usize

Returns the first dimension shape

fn shape_2d(&self) -> (usize, usize)

Returns the first and second dimension shapes

fn shape_3d(&self) -> (usize, usize, usize)

Returns the first, second and third dimension shapes

fn shape_4d(&self) -> (usize, usize, usize, usize)

Returns the first, second, third and fourth dimension shapes

impl StructuralPartialEq for NumericArrayV

impl TryFrom<Value> for NumericArrayV

Available on crate feature views only.

type Error = MinarrowError

The type returned in the event of a conversion error.

fn try_from(v: Value) -> Result<Self, Self::Error>

Performs the conversion.