Struct PackedRow 

pub struct PackedRow { /* private fields */ }

Packed row format with O(1) column access

Memory Layout:

[null_bitmap: ⌈k/8⌉ bytes][offsets: 4×k bytes][col_data...]

Total overhead: ⌈k/8⌉ + 4k bytes

Implementations

impl PackedRow

pub fn pack( schema: &PackedTableSchema, values: &HashMap<String, SochValue>, ) -> Self

Pack values into binary format - O(k)

Arguments

• schema - Table schema defining column order and types
• values - Column name to value mapping

Returns

A packed row ready for storage

pub fn pack_slice( schema: &PackedTableSchema, values: &[Option<&SochValue>], ) -> Self

Pack values from a slice - zero allocation on caller side

Arguments

• schema - Table schema defining column order and types
• values - Slice of optional values in column order (None = NULL)

Performance

• Eliminates HashMap construction overhead (~6 allocations per row)
• Uses stack buffer for small rows (< 512 bytes)
• ~2-3× faster than pack() for bulk inserts

pub fn unpack_to_vec(&self, schema: &PackedTableSchema) -> Vec<SochValue>

Unpack to Vec - more efficient than HashMap for iteration

Returns values in schema column order. Use when you need to iterate over all columns without the overhead of HashMap lookups.

pub fn get_column( &self, idx: usize, col_type: PackedColumnType, ) -> Option<SochValue>

O(1) column access by index

Arguments

• idx - Column index (0-based)
• col_type - Expected column type

Returns

The value at the column, or None if index is out of bounds

pub fn get_by_name( &self, schema: &PackedTableSchema, name: &str, ) -> Option<SochValue>

Get column by name using schema

pub fn as_bytes(&self) -> &[u8]

Get raw bytes for WAL/storage

pub fn into_bytes(self) -> Vec<u8>

Get raw bytes as owned vector

pub fn from_bytes(data: Vec<u8>, num_cols: usize) -> Result<Self>

Reconstruct a PackedRow from bytes

Arguments

• data - Raw bytes from storage
• num_cols - Number of columns in the schema

pub fn unpack(&self, schema: &PackedTableSchema) -> HashMap<String, SochValue>

Unpack all columns into a HashMap

pub fn num_columns(&self) -> usize

Get the number of columns

pub fn size(&self) -> usize

Get the total size in bytes