Struct der::asn1::AnyRef

source ·
pub struct AnyRef<'a> { /* private fields */ }
Expand description

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

This is a zero-copy reference type which borrows from the input data.

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§

source§

impl<'a> AnyRef<'a>

source

pub const NULL: Self = _

AnyRef representation of the ASN.1 NULL type.

source

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

Create a new AnyRef from the provided Tag and DER bytes.

source

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

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

source

pub fn decode_as<T>(self) -> Result<T>
where T: Choice<'a> + DecodeValue<'a>,

Attempt to decode this AnyRef type into the inner value.

source

pub fn is_null(self) -> bool

Is this value an ASN.1 NULL value?

source

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

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

Trait Implementations§

source§

impl<'a> Choice<'a> for AnyRef<'a>

source§

fn can_decode(_: Tag) -> bool

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

impl<'a> Clone for AnyRef<'a>

source§

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

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl<'a> Debug for AnyRef<'a>

source§

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

Formats the value using the given formatter. Read more
source§

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

source§

fn decode<R: Reader<'a>>(reader: &mut R) -> Result<AnyRef<'a>>

Attempt to decode this message using the provided decoder.
source§

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

Parse Self from the provided DER-encoded byte slice.
source§

impl<'a> DecodeValue<'a> for AnyRef<'a>

source§

fn decode_value<R: Reader<'a>>(reader: &mut R, header: Header) -> Result<Self>

Attempt to decode this message using the provided Reader.
source§

impl EncodeValue for AnyRef<'_>

source§

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

Compute the length of this value (sans Tag+Length header) when encoded as ASN.1 DER.
source§

fn encode_value(&self, writer: &mut impl Writer) -> Result<()>

Encode value (sans Tag+Length header) as ASN.1 DER using the provided Writer.
source§

fn header(&self) -> Result<Header>
where Self: Tagged,

Get the Header used to encode this value.
source§

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

source§

fn from(any: &'a Any) -> AnyRef<'a>

Converts to this type from the input type.
source§

impl<'a> From<&'a Ia5String> for AnyRef<'a>

source§

fn from(international_string: &'a Ia5String) -> AnyRef<'a>

Converts to this type from the input type.
source§

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

source§

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

Converts to this type from the input type.
source§

impl<'a> From<&'a PrintableString> for AnyRef<'a>

source§

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

Converts to this type from the input type.
source§

impl<'a> From<&'a TeletexString> for AnyRef<'a>

source§

fn from(teletex_string: &'a TeletexString) -> AnyRef<'a>

Converts to this type from the input type.
source§

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

source§

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

Converts to this type from the input type.
source§

impl<'a> From<Ia5StringRef<'a>> for AnyRef<'a>

source§

fn from(internationalized_string: Ia5StringRef<'a>) -> AnyRef<'a>

Converts to this type from the input type.
source§

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

source§

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

Converts to this type from the input type.
source§

impl<'a> From<OctetStringRef<'a>> for AnyRef<'a>

source§

fn from(octet_string: OctetStringRef<'a>) -> AnyRef<'a>

Converts to this type from the input type.
source§

impl<'a> From<PrintableStringRef<'a>> for AnyRef<'a>

source§

fn from(printable_string: PrintableStringRef<'a>) -> AnyRef<'a>

Converts to this type from the input type.
source§

impl<'a> From<TeletexStringRef<'a>> for AnyRef<'a>

source§

fn from(teletex_string: TeletexStringRef<'a>) -> AnyRef<'a>

Converts to this type from the input type.
source§

impl<'a> From<Utf8StringRef<'a>> for AnyRef<'a>

source§

fn from(utf_string: Utf8StringRef<'a>) -> AnyRef<'a>

Converts to this type from the input type.
source§

impl<'a> From<VideotexStringRef<'a>> for AnyRef<'a>

source§

fn from(printable_string: VideotexStringRef<'a>) -> AnyRef<'a>

Converts to this type from the input type.
source§

impl<'a> Ord for AnyRef<'a>

source§

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

This method returns an Ordering between self and other. Read more
1.21.0 · source§

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

Compares and returns the maximum of two values. Read more
1.21.0 · source§

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

Compares and returns the minimum of two values. Read more
1.50.0 · source§

fn clamp(self, min: Self, max: Self) -> Self
where Self: Sized + PartialOrd,

Restrict a value to a certain interval. Read more
source§

impl<'a> PartialEq for AnyRef<'a>

source§

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

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl<'a> PartialOrd for AnyRef<'a>

source§

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

This method returns an ordering between self and other values if one exists. Read more
1.0.0 · source§

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

This method tests less than (for self and other) and is used by the < operator. Read more
1.0.0 · source§

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

This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
1.0.0 · source§

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

This method tests greater than (for self and other) and is used by the > operator. Read more
1.0.0 · source§

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

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

impl<'a> RefToOwned<'a> for AnyRef<'a>

§

type Owned = Any

The resulting type after obtaining ownership.
source§

fn ref_to_owned(&self) -> Self::Owned

Creates a new object taking ownership of the data
source§

impl Tagged for AnyRef<'_>

source§

fn tag(&self) -> Tag

Get the ASN.1 tag that this type is encoded with.
source§

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

§

type Error = Error

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

impl TryFrom<AnyRef<'_>> for ()

§

type Error = Error

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

impl TryFrom<AnyRef<'_>> for ObjectIdentifier

§

type Error = Error

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

impl TryFrom<AnyRef<'_>> for bool

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'_>) -> Result<bool>

Performs the conversion.
source§

impl TryFrom<AnyRef<'_>> for i128

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'_>) -> Result<Self>

Performs the conversion.
source§

impl TryFrom<AnyRef<'_>> for i16

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'_>) -> Result<Self>

Performs the conversion.
source§

impl TryFrom<AnyRef<'_>> for i32

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'_>) -> Result<Self>

Performs the conversion.
source§

impl TryFrom<AnyRef<'_>> for i64

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'_>) -> Result<Self>

Performs the conversion.
source§

impl TryFrom<AnyRef<'_>> for i8

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'_>) -> Result<Self>

Performs the conversion.
source§

impl TryFrom<AnyRef<'_>> for u128

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'_>) -> Result<Self>

Performs the conversion.
source§

impl TryFrom<AnyRef<'_>> for u16

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'_>) -> Result<Self>

Performs the conversion.
source§

impl TryFrom<AnyRef<'_>> for u32

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'_>) -> Result<Self>

Performs the conversion.
source§

impl TryFrom<AnyRef<'_>> for u64

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'_>) -> Result<Self>

Performs the conversion.
source§

impl TryFrom<AnyRef<'_>> for u8

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'_>) -> Result<Self>

Performs the conversion.
source§

impl<'__der> TryFrom<AnyRef<'__der>> for BitString

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<BitString>

Performs the conversion.
source§

impl<'__der: 'a, 'a> TryFrom<AnyRef<'__der>> for BitStringRef<'a>

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<BitStringRef<'a>>

Performs the conversion.
source§

impl<'__der> TryFrom<AnyRef<'__der>> for GeneralizedTime

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<GeneralizedTime>

Performs the conversion.
source§

impl<'__der> TryFrom<AnyRef<'__der>> for Ia5String

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<Ia5String>

Performs the conversion.
source§

impl<'__der: 'a, 'a> TryFrom<AnyRef<'__der>> for Ia5StringRef<'a>

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<Ia5StringRef<'a>>

Performs the conversion.
source§

impl<'__der> TryFrom<AnyRef<'__der>> for Int

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<Int>

Performs the conversion.
source§

impl<'__der: 'a, 'a> TryFrom<AnyRef<'__der>> for IntRef<'a>

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<IntRef<'a>>

Performs the conversion.
source§

impl<'__der> TryFrom<AnyRef<'__der>> for Null

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<Null>

Performs the conversion.
source§

impl<'__der> TryFrom<AnyRef<'__der>> for OctetString

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<OctetString>

Performs the conversion.
source§

impl<'__der: 'a, 'a> TryFrom<AnyRef<'__der>> for OctetStringRef<'a>

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<OctetStringRef<'a>>

Performs the conversion.
source§

impl<'__der> TryFrom<AnyRef<'__der>> for PrintableString

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<PrintableString>

Performs the conversion.
source§

impl<'__der: 'a, 'a> TryFrom<AnyRef<'__der>> for PrintableStringRef<'a>

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<PrintableStringRef<'a>>

Performs the conversion.
source§

impl<'__der> TryFrom<AnyRef<'__der>> for TeletexString

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<TeletexString>

Performs the conversion.
source§

impl<'__der: 'a, 'a> TryFrom<AnyRef<'__der>> for TeletexStringRef<'a>

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<TeletexStringRef<'a>>

Performs the conversion.
source§

impl<'__der> TryFrom<AnyRef<'__der>> for Uint

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<Uint>

Performs the conversion.
source§

impl<'__der: 'a, 'a> TryFrom<AnyRef<'__der>> for UintRef<'a>

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<UintRef<'a>>

Performs the conversion.
source§

impl<'__der> TryFrom<AnyRef<'__der>> for UtcTime

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<UtcTime>

Performs the conversion.
source§

impl<'__der: 'a, 'a> TryFrom<AnyRef<'__der>> for Utf8StringRef<'a>

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<Utf8StringRef<'a>>

Performs the conversion.
source§

impl<'__der: 'a, 'a> TryFrom<AnyRef<'__der>> for VideotexStringRef<'a>

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'__der>) -> Result<VideotexStringRef<'a>>

Performs the conversion.
source§

impl<'a> TryFrom<AnyRef<'a>> for &'a str

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'a>) -> Result<&'a str>

Performs the conversion.
source§

impl<'a, T> TryFrom<AnyRef<'a>> for ContextSpecific<T>
where T: Decode<'a>,

§

type Error = Error

The type returned in the event of a conversion error.
source§

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

Performs the conversion.
source§

impl<'a> TryFrom<AnyRef<'a>> for String

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'a>) -> Result<String>

Performs the conversion.
source§

impl<'a> TryFrom<AnyRef<'a>> for SystemTime

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(any: AnyRef<'a>) -> Result<SystemTime>

Performs the conversion.
source§

impl ValueOrd for AnyRef<'_>

source§

fn value_cmp(&self, other: &Self) -> Result<Ordering>

Return an Ordering between value portion of TLV-encoded self and other when serialized as ASN.1 DER.
source§

impl<'a> Copy for AnyRef<'a>

source§

impl<'a> Eq for AnyRef<'a>

source§

impl<'a> StructuralPartialEq for AnyRef<'a>

Auto Trait Implementations§

§

impl<'a> Freeze for AnyRef<'a>

§

impl<'a> RefUnwindSafe for AnyRef<'a>

§

impl<'a> Send for AnyRef<'a>

§

impl<'a> Sync for AnyRef<'a>

§

impl<'a> Unpin for AnyRef<'a>

§

impl<'a> UnwindSafe for AnyRef<'a>

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> CloneToUninit for T
where T: Copy,

source§

unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<T> CloneToUninit for T
where T: Clone,

source§

default unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
source§

impl<T> DerOrd for T

source§

fn der_cmp(&self, other: &T) -> Result<Ordering, Error>

Return an Ordering between self and other when serialized as ASN.1 DER.
source§

impl<T> Encode for T
where T: EncodeValue + Tagged,

source§

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

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

source§

fn encode(&self, writer: &mut impl Writer) -> Result<(), Error>

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

source§

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.
source§

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

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

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

Encode this type as DER, returning a byte vector.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.