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

Panics when the supplied codec violates the Codec::min_units_per_value / Codec::max_units_per_value ordering invariant. Validating once at construction lets the hot encode path skip the check.

Trait Implementations

impl<C: Clone> Clone for CodecValueEncoder<C>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<C: Copy> Copy for CodecValueEncoder<C>

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: Eq> Eq for CodecValueEncoder<C>

impl<C: Hash> Hash for CodecValueEncoder<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 CodecValueEncoder<C>

fn eq(&self, other: &CodecValueEncoder<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: PartialEq> StructuralPartialEq for CodecValueEncoder<C>

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

where C: Codec,

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 = CodecEncodeError<<C as Codec>::EncodeError>

Encoding error type.