Struct StructuredMatcher 

pub struct StructuredMatcher { /* private fields */ }

A mutable matcher with independent sequence state.

Implementations

impl StructuredMatcher

pub fn new( program: Arc<StructuredProgram>, ) -> Result<Self, StructuredMatcherError>

Constructs a matcher from an already compiled program.

pub fn backend_name(&self) -> &'static str

Runtime backend selected for this matcher.

pub fn is_accepting(&self) -> bool

Whether the current state accepts a complete document.

pub fn is_dead(&self) -> bool

Whether the current state is a permanent dead end.

pub fn eos_legal(&self) -> bool

Whether end-of-stream is legal at the current state.

pub fn retained_session_bytes(&self) -> usize

Bytes currently retained by this sequence’s mutable backend state.

pub fn peak_session_bytes(&self) -> usize

Peak charged session bytes observed by this matcher.

pub fn advance( &mut self, token_bytes: &[u8], ) -> Result<bool, StructuredMatcherError>

Atomically commits a whole tokenizer token.

pub fn allowed_mask_from_records<'a>( &mut self, mask_vocab_size: usize, records: impl Iterator<Item = (&'a [u8], &'a [u32])>, ) -> Result<Bitmask, StructuredMatcherError>

Computes a mask by speculatively feeding each candidate through one reusable state.

pub fn write_record_mask_words_into<'a>( &mut self, mask_vocab_size: usize, records: impl Iterator<Item = (&'a [u8], &'a [u32])>, out: &mut [u32], ) -> Result<(), StructuredMatcherError>

Clears and fills a packed u32-word mask by scanning vocabulary records, without an intermediate byte buffer. O(1) additional allocation beyond out.

pub fn write_record_mask_le_bytes_into<'a>( &mut self, mask_vocab_size: usize, records: impl Iterator<Item = (&'a [u8], &'a [u32])>, out: &mut [u8], ) -> Result<(), StructuredMatcherError>

Clears and fills a little-endian packed mask by scanning vocabulary records.

pub fn write_mask_le_bytes_into( &mut self, vocabulary: &VocabularyHandle, trie: Option<&BoundByteTrie>, out: &mut [u8], ) -> Result<(), StructuredMatcherError>

Clears and fills a little-endian packed mask without allocating a temporary Bitmask.