Trait dharitri_codec::TopDecodeInput

pub trait TopDecodeInput: Sized {
    type NestedBuffer: NestedDecodeInput;

    // Required methods
    fn byte_len(&self) -> usize;
    fn into_boxed_slice_u8(self) -> Box<[u8]>;
    fn into_nested_buffer(self) -> Self::NestedBuffer;

    // Provided methods
    fn into_u64(self) -> u64 { ... }
    fn into_i64(self) -> i64 { ... }
    fn into_specialized<T, F>(self, else_deser: F) -> Result<T, DecodeError>
       where T: TryStaticCast,
             F: FnOnce(Self) -> Result<T, DecodeError> { ... }
    fn into_specialized_or_exit<T, F, ExitCtx>(
        self,
        c: ExitCtx,
        exit: fn(_: ExitCtx, _: DecodeError) -> !,
        else_deser: F
    ) -> T
       where T: TryStaticCast,
             ExitCtx: Clone,
             F: FnOnce(Self, ExitCtx, fn(_: ExitCtx, _: DecodeError) -> !) -> T { ... }
}

Trait that abstracts away an underlying API for a top-level object deserializer. The underlying API can provide pre-parsed i64/u64 or pre-bundled boxed slices.

Required Associated Types

type NestedBuffer: NestedDecodeInput

Required Methods

fn byte_len(&self) -> usize

Length of the underlying data, in bytes.

fn into_boxed_slice_u8(self) -> Box<[u8]>

Provides the underlying data as an owned byte slice box. Consumes the input object in the process.

fn into_nested_buffer(self) -> Self::NestedBuffer

Provided Methods

fn into_u64(self) -> u64

Retrieves the underlying data as a pre-parsed u64. Expected to panic if the conversion is not possible.

Consumes the input object in the process.

fn into_i64(self) -> i64

Retrieves the underlying data as a pre-parsed i64. Expected to panic if the conversion is not possible.

Consumes the input object in the process.

fn into_specialized<T, F>(self, else_deser: F) -> Result<T, DecodeError>

where T: TryStaticCast, F: FnOnce(Self) -> Result<T, DecodeError>,

fn into_specialized_or_exit<T, F, ExitCtx>( self, c: ExitCtx, exit: fn(_: ExitCtx, _: DecodeError) -> !, else_deser: F ) -> T

where T: TryStaticCast, ExitCtx: Clone, F: FnOnce(Self, ExitCtx, fn(_: ExitCtx, _: DecodeError) -> !) -> T,

Note: currently not in use.

Object Safety

This trait is not object safe.

Implementations on Foreign Types

impl TopDecodeInput for Box<[u8]>

type NestedBuffer = OwnedBytesNestedDecodeInput

fn byte_len(&self) -> usize

fn into_boxed_slice_u8(self) -> Box<[u8]>

fn into_nested_buffer(self) -> Self::NestedBuffer

impl<'a> TopDecodeInput for &'a [u8]

type NestedBuffer = &'a [u8]

fn byte_len(&self) -> usize

fn into_u64(self) -> u64

fn into_i64(self) -> i64

fn into_boxed_slice_u8(self) -> Box<[u8]>

fn into_nested_buffer(self) -> Self::NestedBuffer

Implementors

impl TopDecodeInput for Vec<u8>

type NestedBuffer = OwnedBytesNestedDecodeInput