Struct CodecBufferedDecoder 

pub struct CodecBufferedDecoder<C> { /* private fields */ }

Decodes encoded units into caller-provided value buffers by using a Codec.

CodecBufferedDecoder is a policy-free bridge from the low-level unchecked Codec contract to BufferedTranscoder and BufferedDecoder. It leaves incomplete input tails in the caller-provided input slice; callers own input-buffer refill and EOF incomplete-tail policy.

Type Parameters

• C: Low-level codec used to decode values.

Implementations

impl<C> CodecBufferedDecoder<C>

where C: Codec,

pub const fn new(codec: C) -> Self

Creates a buffered decoder backed by codec.

Parameters

• codec: Low-level codec used to decode values.

Returns

Returns a buffered decoder adapter for the supplied codec.

Trait Implementations

impl<C> BufferedDecoder<<C as Codec>::Unit, <C as Codec>::Value> for CodecBufferedDecoder<C>

where C: Codec,

impl<C> BufferedTranscoder<<C as Codec>::Unit, <C as Codec>::Value> for CodecBufferedDecoder<C>

where C: Codec,

fn max_output_len(&self, input_len: usize) -> Result<usize, CapacityError>

Returns an upper bound for decoded values produced from input_len units.

Parameters

• input_len: Source units the caller plans to decode.

Returns

Returns a conservative upper bound for decoded values.

fn max_finish_output_len(&self) -> Result<usize, CapacityError>

Returns the maximum values emitted by finishing internal state.

Returns

Returns the number of values that may still be emitted by finishing state.

fn reset(&mut self)

Resets hook-owned state.

Returns

Returns unit ().

fn transcode( &mut self, input: &[C::Unit], input_index: usize, output: &mut [C::Value], output_index: usize, ) -> Result<TranscodeProgress, Self::Error>

Decodes source units into logical values.

Parameters

• input: Source unit slice.
• input_index: Absolute source index where decoding starts.
• output: Destination value slice.
• output_index: Absolute output value index where writing starts.

Returns

Returns conversion progress for consumed and written counters.

Errors

Returns a decode error when indices are invalid or when conversion fails under hook policy.

fn finish( &mut self, output: &mut [C::Value], output_index: usize, ) -> Result<usize, FinishError<Self::Error>>

Finishes internally retained output after EOF.

Parameters

• output: Destination value slice for final retained values.
• output_index: Absolute output value index where writing starts.

Returns

Returns the number of values written by finalization.

Errors

Returns a finish error if finalization cannot complete.

type Error = CodecDecodeError<<C as Codec>::DecodeError>

Error reported for semantic conversion failures.

impl<C: Clone> Clone for CodecBufferedDecoder<C>

fn clone(&self) -> CodecBufferedDecoder<C>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<C: Debug> Debug for CodecBufferedDecoder<C>

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

Formats the value using the given formatter.

impl<C: Default> Default for CodecBufferedDecoder<C>

fn default() -> CodecBufferedDecoder<C>

Returns the “default value” for a type.

impl<C: Eq> Eq for CodecBufferedDecoder<C>

impl<C: Hash> Hash for CodecBufferedDecoder<C>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<C: PartialEq> PartialEq for CodecBufferedDecoder<C>

fn eq(&self, other: &CodecBufferedDecoder<C>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<C> StructuralPartialEq for CodecBufferedDecoder<C>