Struct DirectoryBlock 

pub struct DirectoryBlock(/* private fields */);

A metadata block summarizing the posting blocks for a single dimension.

Stores one (max_offset, max_weight) pair per posting block, enabling block-max pruning: the query engine skips entire posting blocks whose max_weight * query_weight cannot beat the current top-k threshold.

Serialized as a SparsePostingBlock with bits_per_delta == 0xFF (the directory sentinel). The body layout is:

body = [ max_offset: u32 LE, max_weight: f32 LE ] × num_entries

The header’s max_weight stores the dimension-level maximum weight (max of all per-block max_weights), used for early term pruning.

Implementations

impl DirectoryBlock

pub fn new( max_offsets: &[u32], max_weights: &[f32], ) -> Result<Self, SparsePostingBlockError>

Create a directory block from per-posting-block metadata.

• max_offsets[i]: largest doc offset in posting block i
• max_weights[i]: largest weight in posting block i

pub fn from_block(block: SparsePostingBlock) -> Result<Self, SparsePostingBlock>

Interpret a SparsePostingBlock as a directory block. Returns Err with the original block if it is not a directory.

pub fn dim_max_weight(&self) -> f32

Dimension-level maximum weight (max of all per-block max_weights).

pub fn num_blocks(&self) -> usize

Number of posting blocks summarized by this directory.

pub fn entries(&self) -> (Vec<u32>, Vec<f32>)

Extract (max_offsets, max_weights) — one pair per posting block.

pub fn into_block(self) -> SparsePostingBlock

Consume this directory block into its underlying SparsePostingBlock for storage in the blockstore.

Trait Implementations

impl Clone for DirectoryBlock

fn clone(&self) -> DirectoryBlock

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DirectoryBlock

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

Formats the value using the given formatter.