Struct der::asn1::Any

pub struct Any<'a> { /* fields omitted */ }

ASN.1 ANY: represents any explicitly tagged ASN.1 value.

Technically ANY hasn’t been a recommended part of ASN.1 since the X.209 revision from 1988. It was deprecated and replaced by Information Object Classes in X.680 in 1994, and X.690 no longer refers to it whatsoever.

Nevertheless, this crate defines an Any type as it remains a familiar and useful concept which is still extensively used in things like PKI-related RFCs.

Implementations

impl<'a> Any<'a>

pub fn new(tag: Tag, bytes: &'a [u8]) -> Result<Self>

Create a new Any from the provided Tag and byte slice.

pub fn tag(self) -> Tag

Get the tag for this Any type.

pub fn len(self) -> Length

Get the Length of this Any type’s value.

pub fn is_empty(self) -> bool

Is the body of this Any type empty?

pub fn is_null(self) -> bool

Is this value an ASN.1 NULL value?

pub fn as_bytes(self) -> &'a [u8]

Get the raw value for this Any type as a byte slice.

pub fn bit_string(self) -> Result<BitString<'a>>

Attempt to decode an ASN.1 BIT STRING.

pub fn context_specific(self) -> Result<ContextSpecific<'a>>

Attempt to decode an ASN.1 CONTEXT-SPECIFIC field.

pub fn generalized_time(self) -> Result<GeneralizedTime>

Attempt to decode an ASN.1 GeneralizedTime.

pub fn ia5_string(self) -> Result<Ia5String<'a>>

Attempt to decode an ASN.1 IA5String.

pub fn octet_string(self) -> Result<OctetString<'a>>

Attempt to decode an ASN.1 OCTET STRING.

pub fn oid(self) -> Result<ObjectIdentifier>

This is supported on crate feature oid only.

Attempt to decode an ASN.1 OBJECT IDENTIFIER.

pub fn optional<T>(self) -> Result<Option<T>> where
    T: Choice<'a> + TryFrom<Self, Error = Error>, 

Attempt to decode an ASN.1 OPTIONAL value.

pub fn printable_string(self) -> Result<PrintableString<'a>>

Attempt to decode an ASN.1 PrintableString.

pub fn sequence<F, T>(self, f: F) -> Result<T> where
    F: FnOnce(&mut Decoder<'a>) -> Result<T>, 

Attempt to decode this value an ASN.1 SEQUENCE, creating a new nested Decoder and calling the provided argument with it.

pub fn utc_time(self) -> Result<UtcTime>

Attempt to decode an ASN.1 UTCTime.

pub fn utf8_string(self) -> Result<Utf8String<'a>>

Attempt to decode an ASN.1 UTF8String.

Trait Implementations

impl<'a> Choice<'a> for Any<'a>

fn can_decode(_: Tag) -> bool

Is the provided Tag decodable as a variant of this CHOICE?

impl<'a> Clone for Any<'a>

fn clone(&self) -> Any<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Any<'a>

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

Formats the value using the given formatter.

impl<'a> Decodable<'a> for Any<'a>

fn decode(decoder: &mut Decoder<'a>) -> Result<Any<'a>>

Attempt to decode this message using the provided decoder.

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

Parse Self from the provided DER-encoded byte slice.

impl<'a> Encodable for Any<'a>

fn encoded_len(&self) -> Result<Length>

Compute the length of this value in bytes when encoded as ASN.1 DER.

fn encode(&self, encoder: &mut Encoder<'_>) -> Result<()>

Encode this value as ASN.1 DER using the provided Encoder.

fn encode_to_slice<'a>(&self, buf: &'a mut [u8]) -> Result<&'a [u8]>

Encode this value to the provided byte slice, returning a sub-slice containing the encoded message.

fn encode_to_vec(&self, buf: &mut Vec<u8>) -> Result<Length>

This is supported on crate feature alloc only.

Encode this message as ASN.1 DER, appending it to the provided byte vector.

fn to_vec(&self) -> Result<Vec<u8>>

This is supported on crate feature alloc only.

Serialize this message as a byte vector.

impl<'a> From<&'a ObjectIdentifier> for Any<'a>

fn from(oid: &'a ObjectIdentifier) -> Any<'a>

Performs the conversion.

impl<'a> From<()> for Any<'a>

fn from(_: ()) -> Any<'a>

Performs the conversion.

impl<'a> From<BitString<'a>> for Any<'a>

fn from(bit_string: BitString<'a>) -> Any<'a>

Performs the conversion.

impl<'a> From<Ia5String<'a>> for Any<'a>

fn from(printable_string: Ia5String<'a>) -> Any<'a>

Performs the conversion.

impl<'a> From<Null> for Any<'a>

fn from(_: Null) -> Any<'a>

Performs the conversion.

impl<'a> From<OctetString<'a>> for Any<'a>

fn from(octet_string: OctetString<'a>) -> Any<'a>

Performs the conversion.

impl<'a> From<PrintableString<'a>> for Any<'a>

fn from(printable_string: PrintableString<'a>) -> Any<'a>

Performs the conversion.

impl<'a> From<Sequence<'a>> for Any<'a>

fn from(seq: Sequence<'a>) -> Any<'a>

Performs the conversion.

impl<'a, T> From<SetOfRef<'a, T>> for Any<'a> where
    T: Clone + Decodable<'a> + Encodable + Ord, 

fn from(set: SetOfRef<'a, T>) -> Any<'a>

Performs the conversion.

impl<'a> From<Utf8String<'a>> for Any<'a>

fn from(printable_string: Utf8String<'a>) -> Any<'a>

Performs the conversion.

impl<'a> Ord for Any<'a>

fn cmp(&self, other: &Any<'a>) -> Ordering

This method returns an Ordering between self and other.

#[must_use]

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]

fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl<'a> PartialEq<Any<'a>> for Any<'a>

fn eq(&self, other: &Any<'a>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Any<'a>) -> bool

This method tests for !=.

impl<'a> PartialOrd<Any<'a>> for Any<'a>

fn partial_cmp(&self, other: &Any<'a>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

#[must_use]

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

#[must_use]

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

#[must_use]

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

#[must_use]

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'a> TryFrom<&'a [u8]> for Any<'a>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(bytes: &'a [u8]) -> Result<Any<'a>>

Performs the conversion.

impl TryFrom<Any<'_>> for GeneralizedTime

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: Any<'_>) -> Result<GeneralizedTime>

Performs the conversion.

impl TryFrom<Any<'_>> for Null

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: Any<'_>) -> Result<Null>

Performs the conversion.

impl TryFrom<Any<'_>> for ObjectIdentifier

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: Any<'_>) -> Result<ObjectIdentifier>

Performs the conversion.

impl TryFrom<Any<'_>> for UtcTime

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: Any<'_>) -> Result<UtcTime>

Performs the conversion.

impl<'a> TryFrom<Any<'a>> for BitString<'a>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: Any<'a>) -> Result<BitString<'a>>

Performs the conversion.

impl<'a> TryFrom<Any<'a>> for ContextSpecific<'a>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: Any<'a>) -> Result<ContextSpecific<'a>>

Performs the conversion.

impl<'a> TryFrom<Any<'a>> for Ia5String<'a>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: Any<'a>) -> Result<Ia5String<'a>>

Performs the conversion.

impl<'a> TryFrom<Any<'a>> for UIntBytes<'a>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: Any<'a>) -> Result<UIntBytes<'a>>

Performs the conversion.

impl<'a> TryFrom<Any<'a>> for OctetString<'a>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: Any<'a>) -> Result<OctetString<'a>>

Performs the conversion.

impl<'a> TryFrom<Any<'a>> for PrintableString<'a>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: Any<'a>) -> Result<PrintableString<'a>>

Performs the conversion.

impl<'a> TryFrom<Any<'a>> for Sequence<'a>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: Any<'a>) -> Result<Self>

Performs the conversion.

impl<'a, T> TryFrom<Any<'a>> for SetOfRef<'a, T> where
    T: Clone + Decodable<'a> + Encodable + Ord, 

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: Any<'a>) -> Result<Self>

Performs the conversion.

impl<'a> TryFrom<Any<'a>> for Utf8String<'a>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: Any<'a>) -> Result<Utf8String<'a>>

Performs the conversion.

impl<'a> Copy for Any<'a>

impl<'a> Eq for Any<'a>

impl<'a> StructuralEq for Any<'a>

impl<'a> StructuralPartialEq for Any<'a>