Struct TextArrayV 

pub struct TextArrayV {
    pub array: TextArray,
    pub offset: usize,
    /* private fields */
}

TextArrayView

Borrowed, indexable view into a [offset .. offset + len) window of a TextArray.

Purpose

• Zero-copy access to contiguous UTF-8 values in either StringArray or CategoricalArray form.
• Allows null counts for the view to be cached to speed up scans.

Fields

• array: the backing TextArray.
• offset: starting index of the view.
• len: number of logical elements in the view.
• null_count: cached Option<usize> of nulls for this range.

Notes

• TextArrayV is not thread-safe due to its use of Cell for caching the null count.
• Use slice to derive smaller views from this one.
• Use to_text_array to materialise the data.

Fields

array: TextArray

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 TextArrayV

pub fn new(array: TextArray, offset: usize, len: usize) -> TextArrayV

Creates a new TextArrayView with the given offset and length.

pub fn new_nc( array: TextArray, offset: usize, len: usize, null_count: usize, ) -> TextArrayV

Creates a new TextArrayView with a precomputed null count.

pub fn is_empty(&self) -> bool

Returns true if the view is empty.

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

Returns the value at logical index i as an Option<&str>.

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

Returns a sliced view into a subrange of this view.

pub fn len(&self) -> usize

Returns the length of the window

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 to_text_array(&self) -> TextArray

Returns an owned TextArray clone of the window.

pub fn end(&self) -> usize

Returns the end index of the view.

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

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

pub fn null_count(&self) -> usize

Returns the number of nulls in the view.

Caches it after the first calculation.

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 TextArrayV instance.

Trait Implementations

impl Clone for TextArrayV

fn clone(&self) -> TextArrayV

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Concatenate for TextArrayV

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

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

Notes

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

impl Debug for TextArrayV

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

Formats the value using the given formatter.

impl Display for TextArrayV

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

Formats the value using the given formatter.

impl<'a> From<&'a [&'a str]> for TextArrayV

fn from(strings: &'a [&'a str]) -> TextArrayV

Converts to this type from the input type.

impl From<Array> for TextArrayV

fn from(array: Array) -> TextArrayV

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<TextArray> for TextArrayV

fn from(array: TextArray) -> TextArrayV

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 From<Vec64<String>> for TextArrayV

fn from(strings: Vec64<String>) -> TextArrayV

Converts to this type from the input type.

impl From<Vec<String>> for TextArrayV

fn from(strings: Vec<String>) -> TextArrayV

Converts to this type from the input type.

impl PartialEq for TextArrayV

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

Equality operator ==.

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

Inequality operator !=.

impl Shape for TextArrayV

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 TextArrayV