Struct Null 

pub struct Null;

A array where all values are null.

This mirrors the Apache Arrow Null array encoding and provides an efficient representation for arrays containing only null values. No actual data is stored, only the length.

All operations on null arrays return null values or indicate invalid data.

Examples

use vortex_array::arrays::NullArray;
use vortex_array::IntoArray;

// Create a null array with 5 elements
let array = NullArray::new(5);

// Slice the array - still contains nulls
let sliced = array.slice(1..3)?;
assert_eq!(sliced.len(), 2);

// All elements are null
let scalar = array.scalar_at(0).unwrap();
assert!(scalar.is_null());

Implementations

impl Null

pub const TAKE_RULES: ParentRuleSet<Self>

impl Null

pub const ID: ArrayId

Trait Implementations

impl CastReduce for Null

fn cast( array: ArrayView<'_, Null>, dtype: &DType, ) -> VortexResult<Option<ArrayRef>>

impl Clone for Null

fn clone(&self) -> Null

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Null

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

Formats the value using the given formatter.

impl FilterReduce for Null

fn filter( _array: ArrayView<'_, Null>, mask: &Mask, ) -> VortexResult<Option<ArrayRef>>

Filter an array with the provided mask without reading buffers.

impl MaskReduce for Null

fn mask( array: ArrayView<'_, Null>, _mask: &ArrayRef, ) -> VortexResult<Option<ArrayRef>>

impl OperationsVTable<Null> for Null

fn scalar_at( _array: ArrayView<'_, Null>, _index: usize, _ctx: &mut ExecutionCtx, ) -> VortexResult<Scalar>

Fetch the scalar at the given index.

impl SliceReduce for Null

fn slice( _array: ArrayView<'_, Self>, range: Range<usize>, ) -> VortexResult<Option<ArrayRef>>

Slice an array with the provided range without reading buffers.

impl TakeReduce for Null

fn take( array: ArrayView<'_, Null>, indices: &ArrayRef, ) -> VortexResult<Option<ArrayRef>>

Take elements from an array at the given indices without reading buffers.

impl VTable for Null

type ArrayData = EmptyArrayData

type OperationsVTable = Null

type ValidityVTable = Null

fn id(&self) -> ArrayId

Returns the ID of the array.

fn validate( &self, _data: &EmptyArrayData, dtype: &DType, _len: usize, _slots: &[Option<ArrayRef>], ) -> VortexResult<()>

Validates that externally supplied logical metadata matches the array data.

fn nbuffers(_array: ArrayView<'_, Self>) -> usize

Returns the number of buffers in the array.

fn buffer(_array: ArrayView<'_, Self>, idx: usize) -> BufferHandle

Returns the buffer at the given index.

fn buffer_name(_array: ArrayView<'_, Self>, _idx: usize) -> Option<String>

Returns the name of the buffer at the given index, or None if unnamed.

fn slot_name(_array: ArrayView<'_, Self>, idx: usize) -> String

Returns the name of the slot at the given index.

fn serialize( _array: ArrayView<'_, Self>, _session: &VortexSession, ) -> VortexResult<Option<Vec<u8>>>

Serialize metadata into a byte buffer for IPC or file storage. Return None if the array cannot be serialized.

fn deserialize( &self, dtype: &DType, len: usize, metadata: &[u8], _buffers: &[BufferHandle], _children: &dyn ArrayChildren, _session: &VortexSession, ) -> VortexResult<ArrayParts<Self>>

Deserialize an array from serialized components.

fn reduce_parent( array: ArrayView<'_, Self>, parent: &ArrayRef, child_idx: usize, ) -> VortexResult<Option<ArrayRef>>

Attempt to perform a reduction of the parent of this array.

fn execute( array: Array<Self>, _ctx: &mut ExecutionCtx, ) -> VortexResult<ExecutionResult>

Execute this array by returning an ExecutionResult.

fn nchildren(array: ArrayView<'_, Self>) -> usize

Returns the number of children in the array.

fn child(array: ArrayView<'_, Self>, idx: usize) -> ArrayRef

Returns the child at the given index.

fn child_name(array: ArrayView<'_, Self>, idx: usize) -> String

Returns the name of the child at the given index.

fn append_to_builder( array: ArrayView<'_, Self>, builder: &mut dyn ArrayBuilder, ctx: &mut ExecutionCtx, ) -> VortexResult<()>

Writes the array into a canonical builder.

fn execute_parent( array: ArrayView<'_, Self>, parent: &ArrayRef, child_idx: usize, ctx: &mut ExecutionCtx, ) -> VortexResult<Option<ArrayRef>>

Attempt to execute the parent of this array.

fn reduce(array: ArrayView<'_, Self>) -> VortexResult<Option<ArrayRef>>

Attempt to reduce the array to a simpler representation.

impl ValidityVTable<Null> for Null

fn validity(_array: ArrayView<'_, Null>) -> VortexResult<Validity>

Returns the Validity of the array.