Struct ColumnArrayT 

pub struct ColumnArrayT<T>
where
    T: Column + 'static,
{ /* private fields */ }

Typed wrapper for ColumnArray that provides type-safe access to nested column

This is analogous to ColumnArrayT<T> in clickhouse-cpp, providing compile-time type safety for array operations.

Reference Implementation: See clickhouse-cpp/clickhouse/columns/array.h

Implementations

impl<T> ColumnArrayT<T>

where T: Column + 'static,

pub fn with_nested(nested: Arc<T>) -> Self

Create a new typed array column from a typed nested column

pub fn new(type_: Type) -> Result<Self>

Create a new typed array column from an array type

Returns an error if the nested column type doesn’t match T

pub fn with_capacity(type_: Type, capacity: usize) -> Result<Self>

Create with reserved capacity

pub fn nested_typed(&self) -> &T

Get typed reference to the nested column

This is safe because we verify the type at construction

pub fn nested_typed_mut(&mut self) -> Result<&mut T>

Get typed mutable reference to the nested column

Returns an error if the column has multiple Arc references

pub fn append_array<F>(&mut self, build_fn: F) -> Result<()>

where F: FnOnce(&mut T),

Append an array by building it with a closure

The closure receives a mutable reference to the nested column and can append elements. The array length is calculated automatically.

Example

let mut arr =
ColumnArrayT::<ColumnUInt64>::new(Type::array(Type::uint64()))?;
arr.append_array(|nested| {
    nested.append(1);
    nested.append(2);
    nested.append(3);
})?;

pub fn append_array_column(&mut self, array_data: ColumnRef)

Append an entire column as a single array element

pub fn append_len(&mut self, len: u64)

Append an array specified by length

The caller must ensure that len elements have been added to the nested column

pub fn at(&self, index: usize) -> ColumnRef

Get the array at the given index as a sliced column

pub fn get_array_range(&self, index: usize) -> Option<(usize, usize)>

Get the start and end indices for the array at the given index

pub fn get_array_len(&self, index: usize) -> Option<usize>

Get the length of the array at the given index

pub fn offsets(&self) -> &[u64]

Get the offsets

pub fn len(&self) -> usize

Get the number of arrays

pub fn is_empty(&self) -> bool

Check if the array column is empty

pub fn inner(&self) -> &ColumnArray

Get reference to inner ColumnArray

pub fn inner_mut(&mut self) -> &mut ColumnArray

Get mutable reference to inner ColumnArray

pub fn into_inner(self) -> ColumnArray

Convert into inner ColumnArray

Trait Implementations

impl<T> Column for ColumnArrayT<T>

where T: Column + 'static,

fn column_type(&self) -> &Type

Get the type of this column

fn size(&self) -> usize

Get the number of rows in this column

fn clear(&mut self)

Clear all data from the column

fn reserve(&mut self, new_cap: usize)

Reserve capacity for at least new_cap elements

fn append_column(&mut self, other: ColumnRef) -> Result<()>

Append another column’s data to this column

fn load_from_buffer(&mut self, buffer: &mut &[u8], rows: usize) -> Result<()>

Load column data from byte buffer

fn load_prefix(&mut self, buffer: &mut &[u8], rows: usize) -> Result<()>

Load column prefix from byte buffer (for types that need prefix data) Default implementation is a no-op. Override for types like LowCardinality. This matches C++ clickhouse-cpp’s LoadPrefix pattern.

fn save_prefix(&self, buffer: &mut BytesMut) -> Result<()>

Save column prefix to byte buffer (for types that need prefix data) Default implementation is a no-op. Override for types like LowCardinality, Array with special nested types. This matches C++ clickhouse-cpp’s SavePrefix pattern.

fn save_to_buffer(&self, buffer: &mut BytesMut) -> Result<()>

Save column data to byte buffer

fn clone_empty(&self) -> ColumnRef

Create an empty clone of this column (same type, no data)

fn slice(&self, begin: usize, len: usize) -> Result<ColumnRef>

Create a slice of this column

fn as_any(&self) -> &dyn Any

Downcast to a concrete column type

fn as_any_mut(&mut self) -> &mut dyn Any

Downcast to a mutable concrete column type