Enum TextArray 

#[repr(C, align(64))]
pub enum TextArray {
    String32(Arc<StringArray<u32>>),
    String64(Arc<StringArray<u64>>),
    Categorical8(Arc<CategoricalArray<u8>>),
    Categorical16(Arc<CategoricalArray<u16>>),
    Categorical32(Arc<CategoricalArray<u32>>),
    Categorical64(Arc<CategoricalArray<u64>>),
    Null,
}

TextArray

Unified Text array container

Purpose

Exists to unify string and categorical operations, simplify API’s and streamline user ergonomics.

Usage:

• It is accessible from Array using .str(), and provides typed variant access via for e.g., .str64(), so one can drill down to the required granularity via myarr.str().str64()
• This streamlines function implementations, and, despite the additional enum layer, matching lanes in many real-world scenarios. This is because one can for e.g., unify a function signature with impl Into<TextArray>, and all of the subtypes, plus Array and TextArray, all qualify.
• Additionally, you can then use one Text implementation on the enum dispatch arm for all Text variants, or, in many cases, for the entire text arm when they are the same. This is mostly useful for the NumericArray enum where unifying floats and integers is a very common pattern, however there may be are cases where it’s useful for Categorical and String data too. For e.g., you can do a match on TextArray then just handle those two cases explicitly, or for e.g., accept impl Into<TextArray>, then simply case it to String for some string ops when feeling barbarian vibes.

Typecasting behaviour

• If the enum already holds the given type (which should be known at compile-time), then using accessors like .str32() is zero-cost, as it transfers ownership.
• If you want to keep the original, of course use .clone() beforehand.
• If you use an accessor to a different base type, e.g., .cat32() when it’s a .str32() already in the enum, it will convert it. Therefore, be mindful of performance when this occurs.

Variants

String32(Arc<StringArray<u32>>)

String64(Arc<StringArray<u64>>)

Categorical8(Arc<CategoricalArray<u8>>)

Categorical16(Arc<CategoricalArray<u16>>)

Categorical32(Arc<CategoricalArray<u32>>)

Categorical64(Arc<CategoricalArray<u64>>)

Null

Implementations

impl TextArray

pub fn len(&self) -> usize

Returns the logical length of the text array.

pub fn null_mask(&self) -> Option<&Bitmask>

Returns the underlying null mask, if any.

pub fn append_array(&mut self, other: &TextArray)

Appends all values (and null mask if present) from other into self.

Panics if the two arrays are of different variants or incompatible types.

This function uses copy-on-write semantics for arrays wrapped in Arc. If self is the only owner of its data, appends are performed in place without copying. If the array data is shared (Arc reference count > 1), the data is first cloned (so the mutation does not affect other owners), and the append is then performed on the unique copy.

This ensures that calling append_array never mutates data referenced elsewhere, but also avoids unnecessary cloning when the data is uniquely owned.

pub fn append_range( &mut self, other: &TextArray, offset: usize, len: usize, ) -> Result<(), MinarrowError>

pub fn insert_rows( &mut self, index: usize, other: &TextArray, ) -> Result<(), MinarrowError>

Inserts all values (and null mask if present) from other into self at the specified index.

This is an O(n) operation.

Returns an error if the two arrays are of different variants or incompatible types, or if the index is out of bounds.

This function uses copy-on-write semantics for arrays wrapped in Arc.

pub fn split( self, index: usize, ) -> Result<(TextArray, TextArray), MinarrowError>

Splits the TextArray at the specified index, consuming self and returning two arrays.

pub fn str32_ref(&self) -> Result<&StringArray<u32>, MinarrowError>

Returns a reference to the inner StringArray<u32> if the variant matches. No conversion or cloning is performed.

pub fn str64_ref(&self) -> Result<&StringArray<u64>, MinarrowError>

Returns a reference to the inner StringArray<u64> if the variant matches. No conversion or cloning is performed.

pub fn cat32_ref(&self) -> Result<&CategoricalArray<u32>, MinarrowError>

Returns a reference to the inner CategoricalArray<u32> if the variant matches. No conversion or cloning is performed.

pub fn cat64_ref(&self) -> Result<&CategoricalArray<u64>, MinarrowError>

Returns a reference to the inner CategoricalArray<u64> if the variant matches. No conversion or cloning is performed.

pub fn cat8_ref(&self) -> Result<&CategoricalArray<u8>, MinarrowError>

Returns a reference to the inner CategoricalArray<u8> if the variant matches. No conversion or cloning is performed.

pub fn cat16_ref(&self) -> Result<&CategoricalArray<u16>, MinarrowError>

Returns a reference to the inner CategoricalArray<u16> if the variant matches. No conversion or cloning is performed.

pub fn str32(self) -> Result<StringArray<u32>, MinarrowError>

Casts to StringArray

• Converts via TryFrom,
• Uses CloneOnWrite (COW) when it’s already a String32.

pub fn str64(self) -> Result<StringArray<u64>, MinarrowError>

Casts to StringArray

• Converts via From or TryFrom, depending on the inner type
• Uses CloneOnWrite (COW) when it’s already a String64.

pub fn cat32(self) -> Result<CategoricalArray<u32>, MinarrowError>

Casts to CategoricalArray

• Converts via From or TryFrom, depending on the inner type
• Uses CloneOnWrite (COW) when it’s already a Categorical32.

pub fn cat64(self) -> Result<CategoricalArray<u64>, MinarrowError>

Casts to CategoricalArray

• Converts via From or TryFrom, depending on the inner type
• Uses CloneOnWrite (COW) when it’s already a Categorical32.

pub fn cat8(self) -> Result<CategoricalArray<u8>, MinarrowError>

Casts to CategoricalArray.

• Converts via From or TryFrom, depending on the inner type
• Uses CloneOnWrite (COW) when it’s already a Categorical8.

pub fn cat16(self) -> Result<CategoricalArray<u16>, MinarrowError>

Casts to CategoricalArray.

• Converts via From or TryFrom, depending on the inner type
• Uses CloneOnWrite (COW) when it’s already a Categorical16.

Trait Implementations

impl Clone for TextArray

fn clone(&self) -> TextArray

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Concatenate for TextArray

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

Concatenates self with other, consuming both and returning a new instance.

impl Debug for TextArray

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

Formats the value using the given formatter.

impl Default for TextArray

fn default() -> TextArray

Returns the “default value” for a type.

impl Display for TextArray

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

Formats the value using the given formatter.

impl PartialEq for TextArray

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

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 TextArray