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: &Self)

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

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

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

Formats the value using the given formatter.

impl From<TextArray> for TextArrayV

fn from(array: TextArray) -> Self

Converts to this type from the input type.

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