Struct TaggedParser

pub struct TaggedParser<'a, TagKind, T, E = Error> {
    pub header: Header<'a>,
    pub inner: T,
    /* private fields */
}

Available on crate feature mtls only.

Fields

header: Header<'a>

inner: T

Implementations

impl<'a, T, E> TaggedParser<'a, Explicit, T, E>

pub const fn new_explicit( class: Class, tag: u32, inner: T, ) -> TaggedParser<'a, Explicit, T, E>

pub fn from_ber_and_then<F>( class: Class, tag: u32, bytes: &'a [u8], op: F, ) -> Result<(&'a [u8], T), Err<E>>

where F: FnOnce(&'a [u8]) -> Result<(&'a [u8], T), Err<E>>, E: From<Error>,

Parse a BER tagged value and apply the provided parsing function to content

After parsing, the sequence object and header are discarded.

Note: this function is provided for Explicit, but there is not difference between explicit or implicit tags. The op function is responsible of handling the content.

pub fn from_der_and_then<F>( class: Class, tag: u32, bytes: &'a [u8], op: F, ) -> Result<(&'a [u8], T), Err<E>>

where F: FnOnce(&'a [u8]) -> Result<(&'a [u8], T), Err<E>>, E: From<Error>,

Parse a DER tagged value and apply the provided parsing function to content

After parsing, the sequence object and header are discarded.

Note: this function is provided for Explicit, but there is not difference between explicit or implicit tags. The op function is responsible of handling the content.

impl<'a, T, E> TaggedParser<'a, Implicit, T, E>

pub const fn new_implicit( class: Class, constructed: bool, tag: u32, inner: T, ) -> TaggedParser<'a, Implicit, T, E>

impl<'a, TagKind, T, E> TaggedParser<'a, TagKind, T, E>

pub const fn new( header: Header<'a>, inner: T, ) -> TaggedParser<'a, TagKind, T, E>

pub const fn assert_class(&self, class: Class) -> Result<(), Error>

pub const fn assert_tag(&self, tag: Tag) -> Result<(), Error>

pub const fn class(&self) -> Class

pub const fn tag(&self) -> Tag

impl<'a, TagKind, T, E> TaggedParser<'a, TagKind, T, E>

where TaggedParser<'a, TagKind, T, E>: FromBer<'a, E>, E: From<Error>,

pub fn parse_ber( class: Class, tag: Tag, bytes: &'a [u8], ) -> Result<(&'a [u8], TaggedParser<'a, TagKind, T, E>), Err<E>>

impl<'a, TagKind, T, E> TaggedParser<'a, TagKind, T, E>

where TaggedParser<'a, TagKind, T, E>: FromDer<'a, E>, E: From<Error>,

pub fn parse_der( class: Class, tag: Tag, bytes: &'a [u8], ) -> Result<(&'a [u8], TaggedParser<'a, TagKind, T, E>), Err<E>>

Trait Implementations

impl<'a, TagKind, T, E> AsRef<T> for TaggedParser<'a, TagKind, T, E>

fn as_ref(&self) -> &T

Converts this type into a shared reference of the (usually inferred) input type.

impl<'a, T> CheckDerConstraints for TaggedParser<'a, Explicit, T>

where T: CheckDerConstraints,

fn check_constraints(any: &Any<'_>) -> Result<(), Error>

impl<'a, T> CheckDerConstraints for TaggedParser<'a, Implicit, T>

where T: CheckDerConstraints + Tagged,

fn check_constraints(any: &Any<'_>) -> Result<(), Error>

impl<'a, TagKind, T, E> Debug for TaggedParser<'a, TagKind, T, E>

where TagKind: Debug, T: Debug, E: Debug,

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

Formats the value using the given formatter.

impl<'a, TagKind, T, E> DynTagged for TaggedParser<'a, TagKind, T, E>

fn tag(&self) -> Tag

impl<'a, T, E> FromBer<'a, E> for TaggedParser<'a, Explicit, T, E>

where T: FromBer<'a, E>, E: From<Error>,

fn from_ber( bytes: &'a [u8], ) -> Result<(&'a [u8], TaggedParser<'a, Explicit, T, E>), Err<E>>

Attempt to parse input bytes into a BER object

impl<'a, T, E> FromBer<'a, E> for TaggedParser<'a, Implicit, T, E>

where T: TryFrom<Any<'a>, Error = E> + Tagged, E: From<Error>,

fn from_ber( bytes: &'a [u8], ) -> Result<(&'a [u8], TaggedParser<'a, Implicit, T, E>), Err<E>>

Attempt to parse input bytes into a BER object

impl<'a, T, E> FromDer<'a, E> for TaggedParser<'a, Explicit, T, E>

where T: FromDer<'a, E>, E: From<Error>,

fn from_der( bytes: &'a [u8], ) -> Result<(&'a [u8], TaggedParser<'a, Explicit, T, E>), Err<E>>

Attempt to parse input bytes into a DER object (enforcing constraints)

impl<'a, T, E> FromDer<'a, E> for TaggedParser<'a, Implicit, T, E>

where T: TryFrom<Any<'a>, Error = E> + CheckDerConstraints + Tagged, E: From<Error>,

fn from_der( bytes: &'a [u8], ) -> Result<(&'a [u8], TaggedParser<'a, Implicit, T, E>), Err<E>>

Attempt to parse input bytes into a DER object (enforcing constraints)

impl<'a, TagKind, T, E> PartialEq for TaggedParser<'a, TagKind, T, E>

where TagKind: PartialEq, T: PartialEq, E: PartialEq,

fn eq(&self, other: &TaggedParser<'a, TagKind, T, E>) -> 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<'a, T> ToDer for TaggedParser<'a, Explicit, T>

where T: ToDer,

fn to_der_len(&self) -> Result<usize, Error>

Get the length of the object (including the header), when encoded

fn write_der_header( &self, writer: &mut dyn Write, ) -> Result<usize, SerializeError>

Attempt to write the DER header to this writer.

fn write_der_content( &self, writer: &mut dyn Write, ) -> Result<usize, SerializeError>

Attempt to write the DER content (all except header) to this writer.

fn to_der_vec(&self) -> Result<Vec<u8>, SerializeError>

Write the DER encoded representation to a newly allocated Vec<u8>.

fn to_der_vec_raw(&self) -> Result<Vec<u8>, SerializeError>

Similar to using to_vec, but uses provided values without changes. This can generate an invalid encoding for a DER object.

fn write_der(&self, writer: &mut dyn Write) -> Result<usize, SerializeError>

Attempt to write the DER encoded representation (header and content) into this writer.

fn write_der_raw(&self, writer: &mut dyn Write) -> Result<usize, SerializeError>

Similar to using to_der, but uses provided values without changes. This can generate an invalid encoding for a DER object.

impl<'a, T> ToDer for TaggedParser<'a, Implicit, T>

where T: ToDer,

fn to_der_len(&self) -> Result<usize, Error>

Get the length of the object (including the header), when encoded

fn write_der(&self, writer: &mut dyn Write) -> Result<usize, SerializeError>

Attempt to write the DER encoded representation (header and content) into this writer.

fn write_der_header( &self, writer: &mut dyn Write, ) -> Result<usize, SerializeError>

Attempt to write the DER header to this writer.

fn write_der_content( &self, writer: &mut dyn Write, ) -> Result<usize, SerializeError>

Attempt to write the DER content (all except header) to this writer.

fn to_der_vec(&self) -> Result<Vec<u8>, SerializeError>

Write the DER encoded representation to a newly allocated Vec<u8>.

fn to_der_vec_raw(&self) -> Result<Vec<u8>, SerializeError>

Similar to using to_vec, but uses provided values without changes. This can generate an invalid encoding for a DER object.

fn write_der_raw(&self, writer: &mut dyn Write) -> Result<usize, SerializeError>

Similar to using to_der, but uses provided values without changes. This can generate an invalid encoding for a DER object.

impl<'a, TagKind, T, E> Eq for TaggedParser<'a, TagKind, T, E>

where TagKind: Eq, T: Eq, E: Eq,

impl<'a, TagKind, T, E> StructuralPartialEq for TaggedParser<'a, TagKind, T, E>