Struct ArrayV 

pub struct ArrayV {
    pub array: Array,
    pub offset: usize,
    /* private fields */
}

ArrayView

Logical, windowed view over an Array.

ArrayView handles indexing offsets automatically so that the View behaves like a regular array.

Purpose

This is used to return an indexable view over a subset of the array. Additionally, it can be used to cache null counts for those regions, which can be used to speed up calculations.

Behaviour

• Indices are always relative to the window.
• Holds a reference to the original Array and window bounds.
• Windowing uses an arc clone
• All access (get/index, etc.) is offset-correct and bounds-checked.
• Null count is computed once (on demand or at creation) and cached for subsequent use.

Notes

• Use slice to derive smaller views without data copy.
• Use to_array to materialise as an owned array.

Fields

array: Array

The outer array that this view is derived from - we retain a reference to it. Importantly, this is the full array - not the view, and thus should not be accessed as though it were the view subset.

offset: usize

The index offset from 0 that for where this view starts from the outer array

Implementations

impl ArrayV

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

Construct a windowed view of array[offset..offset+len), with optional precomputed null count.

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

Construct a windowed view, supplying a precomputed null count.

pub fn len(&self) -> usize

Return the logical length of the view.

pub fn is_empty(&self) -> bool

Returns true if the view is empty.

pub fn spans_backing(&self) -> bool

True when the view spans the entirety of its backing array (offset == 0 and length matches the underlying array length). When true, to_array() Arc-bumps the backing array directly with no buffer copy. When false the view is genuinely windowed and to_array() falls through to slice_clone, reallocating each buffer.

pub fn get<T: MaskedArray + 'static>(&self, i: usize) -> Option<T::CopyType<'_>>

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

pub unsafe fn get_unchecked<T: MaskedArray + 'static>( &self, i: usize, ) -> Option<T::CopyType<'_>>

Returns the value at logical index i within the window (unchecked).

Safety

i must be less than the view’s logical length. No bounds check is performed.

pub fn get_str(&self, i: usize) -> Option<&str>

Returns the string value at logical index i within the window, or None if out of bounds or null.

pub unsafe fn get_str_unchecked(&self, i: usize) -> Option<&str>

Returns the string value at logical index i within the window.

Safety

Skips bounds checks, but will still return None if null.

pub fn get_scalar(&self, i: usize) -> Option<Scalar>

Returns the value at logical index i as a Scalar, respecting nulls.

Delegates to Array::get_scalar with the view’s offset applied.

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

Returns a new window view into a sub-range of this view.

pub fn to_array(&self) -> Array

Materialise the view window as an owned Array.

If the view covers the entire backing array, returns a cheap clone with no data copy. Otherwise deep-copies the window via slice_clone.

pub fn to_typed_vec<T: Numeric>(&self) -> Result<Vec64<T>, KernelError>

Extract array data as Vec64<T>, casting numeric values if necessary.

• If array type matches T exactly, copies the slice directly
• If array is a different numeric type, casts each element via NumCast
• Returns error if array type is not numeric or nulls are present

Example

let av = ArrayV::from(Array::from_float64(...));
let floats: Vec64<f64> = av.to_typed_vec::<f64>()?;

pub fn gather_indices(&self, indices: &[usize]) -> Array

Gather specific indices from this view into a new materialised Array. Indices are relative to this view’s window.

pub fn data_ptr_and_byte_len(&self) -> (*const u8, usize, usize)

Returns a pointer and metadata for raw access

This is not logical length - it is total raw bytes in the buffer, so for non-fixed width types such as bit-packed booleans or strings, please factor this in accordingly.

pub fn end(&self) -> usize

Returns the exclusive end index of the window (relative to parent array).

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

Returns the underlying window as a tuple: (Array, offset, len).

Note: This clones the Arc-wrapped Array.

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

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

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

pub fn null_count(&self) -> usize

Returns the null count in the window, caching the result after first calculation.

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 a windowed view over the underlying null mask, if any.

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

Set the cached null count (advanced use only).

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

Trait Implementations

impl Add for ArrayV

Available on crate feature views only.

type Output = Result<Array, MinarrowError>

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self::Output

Performs the + operation.

impl ByteSize for ArrayV

Available on crate feature views only.

ByteSize for ArrayV - proportional estimate from underlying array

fn est_bytes(&self) -> usize

Returns the estimated byte size of this object in memory.

impl Clone for ArrayV

fn clone(&self) -> ArrayV

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Concatenate for ArrayV

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

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

Notes

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

impl Debug for ArrayV

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

Formats the value using the given formatter.

impl Display for ArrayV

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

Formats the value using the given formatter.

impl Div for ArrayV

Available on crate feature views only.

type Output = Result<Array, MinarrowError>

The resulting type after applying the / operator.

fn div(self, rhs: Self) -> Self::Output

Performs the / operation.

impl<'a> From<&'a ArrayV> for BitmaskV<'a>

Available on crate feature views only.

Extract the boolean data from an ArrayV, preserving the view’s offset and length. Panics if the underlying array is not a BooleanArray variant.

fn from(av: &'a ArrayV) -> Self

Converts to this type from the input type.

impl From<&FieldArray> for ArrayV

&FieldArray -> ArrayView

Arc bumps inner array with offset 0, length self.len().

fn from(field_array: &FieldArray) -> Self

Converts to this type from the input type.

impl From<Array> for ArrayV

Array -> ArrayView

Uses Offset 0 and length self.len()

fn from(array: Array) -> Self

Converts to this type from the input type.

impl From<ArrayV> for Value

Available on crate feature views only.

fn from(v: ArrayV) -> Self

Converts to this type from the input type.

impl From<ArrayV> for BooleanArrayV

fn from(view: ArrayV) -> 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<ArrayV> for TemporalArrayV

fn from(view: ArrayV) -> Self

Converts an ArrayView to a TemporalArrayView, panicking if the array is not temporal.

impl From<ArrayV> for TextArrayV

fn from(view: ArrayV) -> Self

Converts to this type from the input type.

impl From<ArrayV> for Array

ArrayView -> Array

Delegates to to_array, which Arc-bumps the underlying allocation when the view spans its full backing array (offset = 0, len = array.len()) and only reallocates via slice_clone for genuinely windowed views.

fn from(view: ArrayV) -> Self

Converts to this type from the input type.

impl From<BooleanArrayV> for ArrayV

Available on crate feature views only.

BooleanArrayView -> ArrayView

Converts by wrapping the inner Arc as Array::BooleanArray.

fn from(view: BooleanArrayV) -> Self

Converts to this type from the input type.

impl From<FieldArray> for ArrayV

FieldArray -> ArrayView

Takes self.array then offset 0, length self.len())

fn from(field_array: FieldArray) -> 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 From<Scalar> for ArrayV

Available on crate feature scalar_type only.

Scalar -> ArrayView

Converts a Scalar to a length-1 ArrayV, enabling scalar broadcasting in functions that accept impl Into<ArrayV>.

fn from(scalar: Scalar) -> Self

Converts to this type from the input type.

impl From<TemporalArrayV> for ArrayV

Available on crate features datetime and views only.

TemporalArrayView -> ArrayView

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

fn from(view: TemporalArrayV) -> Self

Converts to this type from the input type.

impl From<TextArrayV> for ArrayV

Available on crate feature views only.

TextArrayView -> ArrayView

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

fn from(view: TextArrayV) -> Self

Converts to this type from the input type.

impl Mul for ArrayV

Available on crate feature views only.

type Output = Result<Array, MinarrowError>

The resulting type after applying the * operator.

fn mul(self, rhs: Self) -> Self::Output

Performs the * operation.

impl PartialEq for ArrayV

fn eq(&self, other: &ArrayV) -> 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 Rem for ArrayV

Available on crate feature views only.

type Output = Result<Array, MinarrowError>

The resulting type after applying the % operator.

fn rem(self, rhs: Self) -> Self::Output

Performs the % operation.

impl RowSelection for ArrayV

Available on crate feature select only.

type View = ArrayV

The view type returned by selection operations

fn r<S: DataSelector>(&self, selection: S) -> ArrayV

Select rows by index or range

fn get_row_count(&self) -> usize

Get the count for data resolution

impl Shape for ArrayV

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 ArrayV

impl Sub for ArrayV

Available on crate feature views only.

type Output = Result<Array, MinarrowError>

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self::Output

Performs the - operation.

impl TryFrom<Value> for ArrayV

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.