Struct Decoder 

pub struct Decoder<'a, T> { /* private fields */ }

ANS decoder that reconstructs symbols from a token stream.

Tokens must be provided in the reverse of the order they were emitted by the Encoder. After all symbols have been decoded, call finish to verify the decoder returned to its initial state.

Implementations

impl<'a, T> Decoder<'a, T>

where T: Eq + Hash + Copy,

pub fn new(ctx: &'a Context<T>) -> Self

Creates a new decoder bound to the given context.

pub fn decode(&mut self, tokens: impl Iterator<Item = u32>) -> Option<T>

Decodes one symbol, pulling additional tokens from tokens as needed.

Returns None when the token stream is exhausted.

pub fn decode_all( &mut self, tokens: impl Iterator<Item = u32>, extend: &mut impl Extend<T>, )

Decodes all remaining symbols from tokens and appends them to extend.

pub fn finish(&self) -> Result<(), DecodeError>

Verifies that the decoder ended in the expected final state.

Returns Err(DecodeError::Incomplete) if the internal state does not match the encoder’s initial state, which typically indicates corrupted data.