Struct CodecTranscodeEncoder 

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

Encodes values into caller-provided output units by using a Codec.

CodecTranscodeEncoder is the default bridge from the low-level unchecked Codec contract to the buffered Transcoder and TranscodeEncoder contracts. It encodes complete values only; when the remaining output capacity is smaller than codec.encode_len(value), it stops before consuming that input value and reports crate::TranscodeStatus::NeedOutput.

Type Parameters

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

Implementations

impl<C> CodecTranscodeEncoder<C>

where C: Codec,

pub fn new(codec: C) -> Self

Creates a buffered encoder backed by codec.

Parameters

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

Returns

Returns a buffered encoder adapter for the supplied codec.

pub fn codec(&self) -> &C

Returns a shared reference to the wrapped codec.

pub fn codec_mut(&mut self) -> &mut C

Returns a mutable reference to the wrapped codec.

Mutating a codec during an active stream can invalidate that stream’s assumptions; reset the adapter before continuing with the new codec configuration.

pub fn into_codec(self) -> C

Consumes the adapter and returns its wrapped codec.

Any buffered lifecycle state and internal hooks are discarded.

Trait Implementations

impl<C: Debug> Debug for CodecTranscodeEncoder<C>

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

Formats the value using the given formatter.

impl<C> Default for CodecTranscodeEncoder<C>

where C: Codec + Default,

fn default() -> Self

Creates a default codec-backed buffered encoder.

Returns

Returns an encoder backed by C::default().

impl<C> TranscodeEncoder for CodecTranscodeEncoder<C>

where C: Codec,

type EncodeError = <C as Codec>::EncodeError

Domain error type produced by encode internals.

impl<C> Transcoder for CodecTranscodeEncoder<C>

where C: Codec,

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

Gets the maximum number of output units needed for input_len values.

Parameters

• input_len: Logical input values the caller plans to encode.

Returns

a conservative upper bound for output units.

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

Gets the global maximum units emitted when resetting internal state.

Returns

the maximum units emitted when resetting internal state.

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

Gets the global maximum units emitted by finishing internal state.

Returns

the number of units that may be emitted by finishing state.

fn reset( &mut self, output: &mut [C::Unit], output_index: usize, ) -> Result<usize, TranscodeEncodeErrorOf<C>>

Runs before-reset cleanup and emits stream-start output.

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

Encodes values into the supplied output buffer.

Parameters

• input: Input value slice.
• input_index: Absolute input index where encoding starts.
• output: Destination unit slice.
• output_index: Absolute output index where writing starts.

Returns

Returns conversion progress for consumed input and produced output units.

Errors

Returns an encode error when indices are invalid or when encoding cannot continue under current policy.

fn finish( &mut self, output: &mut [C::Unit], output_index: usize, ) -> Result<usize, TranscodeEncodeErrorOf<C>>

Finishes internally retained output after EOF.

Parameters

• output: Destination unit slice for finalization output.
• output_index: Absolute output index where writing starts.

Returns

Returns the number of units written by finalization.

Errors

Returns a finish error if retained output cannot be fully emitted.

type Input = <C as Codec>::Value

Input unit type accepted by this transcoder.

type Output = <C as Codec>::Unit

Output unit type produced by this transcoder.

type Error = TranscodeEncodeError<<C as Codec>::EncodeError, <C as Codec>::Value>

Complete error type produced by this transcoder.

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

Returns an upper bound for a complete reset -> transcode -> finish stream.

fn transcode_eof( &mut self, input: &[Self::Input], input_index: usize, output: &mut [Self::Output], output_index: usize, ) -> Result<TranscodeProgress, Self::Error>

Converts source units after the caller has established end of input.

fn transcode_complete_into( &mut self, input: &[Self::Input], output: &mut [Self::Output], ) -> Result<usize, Self::Error>

Runs a complete one-shot reset -> transcode -> finish stream.