Struct VecqView 

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

Read-only, zero-copy view over an index file (or any bytes in the same layout). Generic over the byte owner’s lifetime.

Implementations

impl<'a> VecqView<'a>

pub fn from_bytes(bytes: &'a [u8]) -> Result<Self, Error>

Parse bytes as a vecq index file (v1.2+) without copying payloads. v1 files (f32 scales) are not view-eligible: their scale blocks are not the 2-byte layout shared by every current writer.

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn dim(&self) -> usize

pub fn working_dim(&self) -> usize

pub fn bits(&self) -> u8

Code width of the viewed file (4, 5, or 6 bits).

pub fn is_residual(&self) -> bool

Whether the file carries a residual second pass (v1.4).

pub fn prepare_query(&self, q: &[f32]) -> ViewQuery

Prepare a query: truncate to working_dim, normalize, rotate, then normalize again — mirroring the index-side prepare_query exactly so both paths see identical rotated queries.

pub fn score(&self, pq: &ViewQuery, idx: usize) -> f32

Asymmetric score of vector idx — same kernel dispatch and association order as crate::store::VecqIndex::score.

pub fn search(&self, q: &[f32], k: usize) -> Vec<(usize, f32)>

Brute-force top-k over the borrowed codes — same bounded heap, key encoding, batched kernel dispatch, and output ordering as crate::store::VecqIndex::search.