Struct NullableColumn 

pub struct NullableColumn<T: Clone> {
    pub values: Vec<T>,
    pub validity: BitMask,
}

A nullable column: values buffer + validity bitmap.

The validity bitmap uses the same bit layout as BitMask (LSB-first, tail bits zeroed). validity.get(i) == true means values[i] is valid (not null). When validity.get(i) == false, values[i] holds a type-appropriate zero/empty value but MUST NOT be read as valid data.

Fields

values: Vec<T>

validity: BitMask

Implementations

impl<T: Clone + Default> NullableColumn<T>

pub fn from_values(values: Vec<T>) -> Self

Create a fully valid (non-null) nullable column from a slice.

pub fn new(values: Vec<T>, validity: BitMask) -> Self

Create a nullable column with explicit validity. Panics if values.len() != validity.nrows().

pub fn len(&self) -> usize

Number of rows.

pub fn is_null(&self, i: usize) -> bool

Is the value at row i null?

pub fn get(&self, i: usize) -> Option<&T>

Get the value at i if non-null.

pub fn count_valid(&self) -> usize

Count non-null rows.

pub fn gather(&self, indices: &[usize]) -> Self

Gather rows by index (for join/arrange materialisation).

Trait Implementations

impl<T: Clone + Clone> Clone for NullableColumn<T>

fn clone(&self) -> NullableColumn<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug + Clone> Debug for NullableColumn<T>

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

Formats the value using the given formatter.