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) -> ArrayV

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, ) -> ArrayV

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 get<T>(&self, i: usize) -> Option<<T as MaskedArray>::CopyType>

where T: MaskedArray + 'static,

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

pub fn get_unchecked<T>(&self, i: usize) -> Option<<T as MaskedArray>::CopyType>

where T: MaskedArray + 'static,

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

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 slice(&self, offset: usize, len: usize) -> ArrayV

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

pub fn to_array(&self) -> Array

Materialise a deep copy as an owned Array for the window.

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

where T: Numeric,

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 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 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: ArrayV) -> Result<ArrayV, 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<(), Error>

Formats the value using the given formatter.

impl Display for ArrayV

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

Formats the value using the given formatter.

impl From<&FieldArray> for ArrayV

&FieldArray -> ArrayView

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

fn from(field_array: &FieldArray) -> ArrayV

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) -> ArrayV

Converts to this type from the input type.

impl From<ArrayV> for BooleanArrayV

fn from(view: ArrayV) -> BooleanArrayV

Converts to this type from the input type.

impl From<ArrayV> for NumericArrayV

fn from(view: ArrayV) -> NumericArrayV

Converts to this type from the input type.

impl From<ArrayV> for TextArrayV

fn from(view: ArrayV) -> TextArrayV

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) -> ArrayV

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) -> ArrayV

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) -> ArrayV

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) -> ArrayV

Converts to this type from the input type.

impl PartialEq for ArrayV

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

Equality operator ==.

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

Inequality operator !=.

impl RowSelection for ArrayV

Available on crate feature select only.

type View = ArrayV

The view type returned by selection operations

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

where S: DataSelector,

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