Enum Column 

pub enum Column {
    Numeric {
        values: Vec<f64>,
        validity: ValidityBitmap,
    },
    Boolean {
        values: Vec<bool>,
        validity: ValidityBitmap,
    },
    Categorical {
        dictionary: Vec<String>,
        indices: Vec<u32>,
        validity: ValidityBitmap,
    },
    Text {
        values: Vec<String>,
        validity: ValidityBitmap,
    },
}

A typed column with validity bitmap for missing values.

All variants store values in a dense array alongside a ValidityBitmap. Invalid positions hold a default value (0.0, false, empty string, or index 0) that should be ignored.

Variants

Numeric

Dense f64 values. Null positions hold 0.0.

Fields

values: Vec<f64>

validity: ValidityBitmap

Boolean

Boolean values. Null positions hold false.

Fields

values: Vec<bool>

validity: ValidityBitmap

Categorical

Dictionary-encoded categorical column.

dictionary contains unique string values. indices maps each row to a dictionary index. Null positions have index 0 (ignored via validity bit).

Fields

dictionary: Vec<String>

indices: Vec<u32>

validity: ValidityBitmap

Text

Free-form text column. Null positions hold an empty string.

Fields

values: Vec<String>

validity: ValidityBitmap

Implementations

impl Column

pub fn numeric(values: Vec<f64>, validity: ValidityBitmap) -> Self

Creates a numeric column.

pub fn boolean(values: Vec<bool>, validity: ValidityBitmap) -> Self

Creates a boolean column.

pub fn categorical( dictionary: Vec<String>, indices: Vec<u32>, validity: ValidityBitmap, ) -> Self

Creates a categorical column from a dictionary and indices.

pub fn text(values: Vec<String>, validity: ValidityBitmap) -> Self

Creates a text column.

pub fn data_type(&self) -> DataType

Returns the data type of this column.

pub fn len(&self) -> usize

Returns the number of rows in this column.

pub fn is_empty(&self) -> bool

Returns true if the column has no rows.

pub fn validity(&self) -> &ValidityBitmap

Returns a reference to the validity bitmap.

pub fn null_count(&self) -> usize

Returns the number of null values.

pub fn valid_count(&self) -> usize

Returns the number of valid (non-null) values.

pub fn is_valid(&self, idx: usize) -> bool

Returns true if the value at idx is valid (not null).

pub fn as_numeric(&self) -> Option<&[f64]>

Returns the numeric values, or None if not a numeric column.

pub fn as_boolean(&self) -> Option<&[bool]>

Returns the boolean values, or None if not a boolean column.

pub fn valid_numeric_values(&self) -> Option<Vec<f64>>

Returns valid numeric values (nulls excluded) as a new Vec<f64>.

pub fn category_at(&self, idx: usize) -> Option<&str>

Returns the category string for a given row index in a categorical column.

pub fn text_at(&self, idx: usize) -> Option<&str>

Returns the text value for a given row index in a text column.

Trait Implementations

impl Clone for Column

fn clone(&self) -> Column

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Column

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

Formats the value using the given formatter.

impl PartialEq for Column

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