Struct Proxied 

pub struct Proxied<E, Tag = ()>(/* private fields */);

Proxied is a special encoder which translates the encoded type into its “proxy” type first, simplifying the encoding logic. It provides value-encoding implementations for types that implement the proxied conversions defined in Proxiable and DistinguishedProxiable, which can then be delegated (such as with delegate_value_encoding!) to another encoding to be used as field types in messages.

Proxied itself cannot be used to encode message fields because its trait support means that it cannot ever implement Encoder, Decoder etc. for its supported, un-wrapped types; only when they are nested in Option<T>, or appear in a oneof, or in some other container.

Trait Implementations

impl<'a, T, E, Tag> DistinguishedValueBorrowDecoder<'a, Proxied<E, Tag>, T> for ()

where T: DistinguishedProxiable<Tag> + Eq, (): ForOverwrite<E, T::Proxy> + DistinguishedValueBorrowDecoder<'a, E, T::Proxy>,

const CHECKS_EMPTY: bool

Indicates whether the ALLOW_EMPTY argument in borrow_decode_value_distinguished has any effect. Some decoder implementations can more cheaply determine whether they were empty during decoding, and will return NotCanonical if ALLOW_EMPTY was false; for these implementations, CHECKS_EMPTY should be set to true. When CHECKS_EMPTY is false, the caller must invoke EmptyState::is_empty after the call if empty states are non-canonical.

fn borrow_decode_value_distinguished<const ALLOW_EMPTY: bool>( value: &mut T, buf: Capped<'_, &'a [u8]>, ctx: RestrictedDecodeContext, ) -> Result<Canonicity, DecodeError>

Decodes a field assuming the encoder’s wire type directly from the buffer, also performing any additional validation required to guarantee that the value would be re-encoded into the exact same bytes.

impl<T, E, Tag> DistinguishedValueDecoder<Proxied<E, Tag>, T> for ()

where T: DistinguishedProxiable<Tag> + Eq, (): ForOverwrite<E, T::Proxy> + DistinguishedValueDecoder<E, T::Proxy>,

const CHECKS_EMPTY: bool

Indicates whether the ALLOW_EMPTY argument in decode_value_distinguished has any effect. Some decoder implementations can more cheaply determine whether they were empty during decoding, and will return NotCanonical if ALLOW_EMPTY was false; for these implementations, CHECKS_EMPTY should be set to true. When CHECKS_EMPTY is false, the caller must invoke EmptyState::is_empty after the call if empty states are non-canonical.

fn decode_value_distinguished<const ALLOW_EMPTY: bool>( value: &mut T, buf: Capped<'_, impl Buf + ?Sized>, ctx: RestrictedDecodeContext, ) -> Result<Canonicity, DecodeError>

Decodes a field assuming the encoder’s wire type directly from the buffer, also performing any additional validation required to guarantee that the value would be re-encoded into the exact same bytes.

impl<'a, T, E, Tag> ValueBorrowDecoder<'a, Proxied<E, Tag>, T> for ()

where T: Proxiable<Tag>, (): ForOverwrite<E, T::Proxy> + ValueBorrowDecoder<'a, E, T::Proxy>,

fn borrow_decode_value( value: &mut T, buf: Capped<'_, &'a [u8]>, ctx: DecodeContext, ) -> Result<(), DecodeError>

Decodes a field assuming the encoder’s wire type directly from the buffer.

impl<T, E, Tag> ValueDecoder<Proxied<E, Tag>, T> for ()

where T: Proxiable<Tag>, (): ForOverwrite<E, T::Proxy> + ValueDecoder<E, T::Proxy>,

fn decode_value<B: Buf + ?Sized>( value: &mut T, buf: Capped<'_, B>, ctx: DecodeContext, ) -> Result<(), DecodeError>

Decodes a field assuming the encoder’s wire type directly from the buffer.

impl<T, E, Tag> ValueEncoder<Proxied<E, Tag>, T> for ()

where T: Proxiable<Tag>, (): ForOverwrite<E, T::Proxy> + ValueEncoder<E, T::Proxy>,

fn encode_value<B: BufMut + ?Sized>(value: &T, buf: &mut B)

Encodes the given value unconditionally. This is guaranteed to emit data to the buffer.

fn prepend_value<B: ReverseBuf + ?Sized>(value: &T, buf: &mut B)

Prepends the given value unconditionally. This is guaranteed to emit data to the buffer.

fn value_encoded_len(value: &T) -> usize

Returns the number of bytes the given value would be encoded as.

fn many_values_encoded_len<I>(values: I) -> usize

where I: ExactSizeIterator, I::Item: Deref<Target = T>,

Returns the number of total bytes to encode all the values in the given container.

impl<T, E, Tag> Wiretyped<Proxied<E, Tag>, T> for ()

where T: Proxiable<Tag>, (): Wiretyped<E, T::Proxy> + ForOverwrite<E, T::Proxy>,

const WIRE_TYPE: WireType