Struct CodecValueEncoder 

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

Encodes one borrowed value into owned units by using a Codec.

CodecValueEncoder is the default bridge from the low-level unchecked Codec contract to the convenience-layer ValueEncoder contract. Each call emits stream-start output through Codec::encode_reset, then encodes one value through Codec::encode, and returns the owned output truncated to the units actually written.

Type Parameters

• C: Low-level codec used to encode one value.

Implementations

impl<C> CodecValueEncoder<C>

where C: Codec,

pub fn new(codec: C) -> Self

Creates an encoder backed by codec.

Parameters

• codec: Low-level codec used to encode one value.

Returns

Returns a value encoder adapter for the supplied codec.

Panics

In debug builds, panics when the supplied codec violates the Codec::MIN_UNITS_PER_VALUE / Codec::MAX_UNITS_PER_VALUE ordering invariant. Release builds skip this check because the invariant is the responsibility of the Codec implementation.

Trait Implementations

impl<C: Debug> Debug for CodecValueEncoder<C>

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

Formats the value using the given formatter.

impl<C: Default> Default for CodecValueEncoder<C>

fn default() -> CodecValueEncoder<C>

Returns the “default value” for a type.

impl<C> ValueEncoder<<C as Codec>::Value> for CodecValueEncoder<C>

where C: Codec, C::Unit: Default,

fn encode(&mut self, input: &C::Value) -> Result<Self::Output, Self::Error>

Encodes one borrowed value into owned units.

Parameters

• input: Value to encode.

Returns

Returns stream-start output followed by the units written for input.

Errors

Returns the wrapped codec’s encode error when reset output or input cannot be represented.

Panics

Panics when the wrapped codec reports more reset output than Codec::MAX_ENCODE_RESET_UNITS or a value width different from Codec::encode_len.

type Output = Vec<<C as Codec>::Unit>

Encoded output type.

type Error = TranscodeError<CodecEncodeError<<C as Codec>::EncodeError>>

Encoding error type.