Struct ColumnReader 

pub struct ColumnReader<'a> { /* private fields */ }

Reads a single column’s values from serialized bytes.

Implementations

impl<'a> ColumnReader<'a>

pub fn open(data: &'a [u8]) -> Self

pub fn field_id(&self) -> FieldId

pub fn doc_count(&self) -> u32

pub fn is_null(&self, doc_id: u32) -> bool

pub fn keyword_ordinal(&self, doc_id: u32) -> Option<u32>

Get the raw dictionary ordinal for a keyword field (no string decode).

pub fn dict_size(&self) -> usize

Number of unique values in the keyword dictionary.

pub fn ordinal_to_string(&self, ordinal: u32) -> Option<&'a str>

Resolve an ordinal back to its string value. None means “no such ordinal”; invalid UTF-8 (corruption only) panics rather than returning None, so the two are never conflated ([[code-must-not-lie]]).

pub fn ensure_dict(&self)

Bulk opt-in: materialize the eager Vec once into the OnceCell so subsequent ordinal_to_string/keyword_value calls take the O(1) populated branch. No-op for Eager/None; idempotent for Blocked (the OnceCell guarantees the O(N) body walk runs at most once). Bulk consumers (sort/collapse/terms-agg finish) call this before their resolve loop so N lookups are O(1) instead of O(DICT_BLOCK_SIZE) seeks.

pub fn keyword_value(&self, doc_id: u32) -> Option<&'a str>

Resolve a doc’s keyword value: ordinal lookup then string decode (both O(1) on a populated/eager dict, block-seek otherwise). Routes through the bounds-checked ordinal_to_string, so a (corruption-only) out-of-range ordinal yields None instead of panicking — making it consistent with ordinal_to_string; for all writer-emitted data the values are identical.

pub fn i64_value(&self, doc_id: u32) -> Option<i64>

pub fn f64_value(&self, doc_id: u32) -> Option<f64>

pub fn bool_value(&self, doc_id: u32) -> Option<bool>

pub fn numeric_value(&self, doc_id: u32) -> Option<f64>

Get the numeric value as f64, regardless of underlying type. Converts i64 → f64. Returns None for non-numeric, null, or constant columns. For constant columns, use is_constant() + constant_value().

pub fn is_constant(&self) -> bool

Returns true if this column uses constant encoding (all non-null values are identical). Enables O(1) aggregation fast-paths.

pub fn constant_value(&self) -> Option<f64>

Get the constant value if this is a constant-encoded column.

pub fn stats(&self) -> Option<&ColumnStats>

Get precomputed column statistics (min, max, null_count) for numeric columns. Returns None for non-numeric types. Enables O(1) aggregation pushdown for min/max/count on unfiltered queries.