Trait Decode 

pub trait Decode<'a>: Sized + 'a {
    type Error: Error + From<Error> + 'static;

    // Required method
    fn decode<R: Reader<'a>>(decoder: &mut R) -> Result<Self, Self::Error>;

    // Provided methods
    fn from_der(bytes: &'a [u8]) -> Result<Self, Self::Error> { ... }
    fn from_der_partial(
        bytes: &'a [u8],
    ) -> Result<(Self, &'a [u8]), Self::Error> { ... }
}

Decode trait parses a complete TLV (Tag-Length-Value) structure.

This trait provides the core abstraction upon which all decoding operations are based.

When decoding fails, a Decode::Error type is thrown. Most ASN.1 DER objects return a builtin der Error type as Decode::Error, which can be made from ErrorKind.

Example

use der::{Any, Decode, Reader};

/// Wrapper around Any, with custom foreign trait support.
///
/// For example: serde Serialize/Deserialize
pub struct AnySerde(pub Any);

impl<'a> Decode<'a> for AnySerde {
    type Error = der::Error;

    fn decode<R: Reader<'a>>(reader: &mut R) -> der::Result<Self> {
        // calls impl Decode for Any
        Ok(Self(Any::decode(reader)?))
    }
}

Required Associated Types

type Error: Error + From<Error> + 'static

Type returned in the event of a decoding error.

Required Methods

fn decode<R: Reader<'a>>(decoder: &mut R) -> Result<Self, Self::Error>

Attempt to decode this TLV message using the provided decoder.

Errors

Returns Self::Error in the event a decoding error occurred.

Provided Methods

fn from_der(bytes: &'a [u8]) -> Result<Self, Self::Error>

Parse Self from the provided DER-encoded byte slice.

Errors

Returns Self::Error in the event a decoding error occurred.

fn from_der_partial(bytes: &'a [u8]) -> Result<(Self, &'a [u8]), Self::Error>

Parse Self from the provided DER-encoded byte slice.

Returns remaining byte slice, without checking for incomplete message.

Errors

Returns Self::Error in the event a decoding error occurred.

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementations on Foreign Types

impl<'a, T> Decode<'a> for Option<T>

where T: Choice<'a>,

type Error = <T as Decode<'a>>::Error

fn decode<R: Reader<'a>>(reader: &mut R) -> Result<Option<T>, Self::Error>

impl<'a, T> Decode<'a> for PhantomData<T>

where T: ?Sized + 'a,

Dummy implementation for PhantomData which allows deriving implementations on structs with phantom fields.

type Error = Error

fn decode<R: Reader<'a>>(_reader: &mut R) -> Result<PhantomData<T>, Error>

Implementors

impl<'a, T> Decode<'a> for Application<T>

where T: Decode<'a>,

type Error = <T as Decode<'a>>::Error

impl<'a, T> Decode<'a> for ContextSpecific<T>

where T: Decode<'a>,

type Error = <T as Decode<'a>>::Error

impl<'a, T> Decode<'a> for Private<T>

where T: Decode<'a>,

type Error = <T as Decode<'a>>::Error

impl<'a, T> Decode<'a> for T

where T: DecodeValue<'a> + FixedTag + 'a,

type Error = <T as DecodeValue<'a>>::Error

impl<'a> Decode<'a> for Any

type Error = Error

impl<'a> Decode<'a> for AnyRef<'a>

type Error = Error

impl<'a> Decode<'a> for Document

type Error = Error

impl<'a> Decode<'a> for Header

type Error = Error

impl<'a> Decode<'a> for Length

type Error = Error

impl<'a> Decode<'a> for Tag

type Error = Error