Struct der::asn1::AnyRef

pub struct AnyRef<'a> { /* private fields */ }

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

impl<'a> AnyRef<'a>

pub const NULL: Self = _

AnyRef representation of the ASN.1 NULL type.

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

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

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

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

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

Attempt to decode this AnyRef type into the inner value.

pub fn is_null(self) -> bool

Is this value an ASN.1 NULL value?

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

Attempt to decode an ASN.1 BIT STRING.

pub fn context_specific<T>(self) -> Result<ContextSpecific<T>>where T: Decode<'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<Ia5StringRef<'a>>

Attempt to decode an ASN.1 IA5String.

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

Attempt to decode an ASN.1 OCTET STRING.

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

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<PrintableStringRef<'a>>

Attempt to decode an ASN.1 PrintableString.

pub fn teletex_string(self) -> Result<TeletexStringRef<'a>>

Attempt to decode an ASN.1 TeletexString.

pub fn videotex_string(self) -> Result<VideotexStringRef<'a>>

Attempt to decode an ASN.1 VideotexString.

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.

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

Attempt to decode an ASN.1 UTCTime.

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

Attempt to decode an ASN.1 UTF8String.

Trait Implementations

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

fn can_decode(_: Tag) -> bool

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

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

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

Returns a copy of the value.

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

Performs copy-assignment from source.

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

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

Formats the value using the given formatter.

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

fn decode<R: Reader<'a>>(reader: &mut R) -> Result<AnyRef<'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 EncodeValue for AnyRef<'_>

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

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

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

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

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

Get the Header used to encode this value.

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

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

Converts to this type from the input type.

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

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

Converts to this type from the input type.

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

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

Converts to this type from the input type.

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

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

Converts to this type from the input type.

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

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

Converts to this type from the input type.

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

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

Converts to this type from the input type.

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

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

Converts to this type from the input type.

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

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

Converts to this type from the input type.

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

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

Converts to this type from the input type.

impl From<bool> for AnyRef<'static>

fn from(value: bool) -> AnyRef<'static>

Converts to this type from the input type.

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

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

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

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

Restrict a value to a certain interval.

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

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

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

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.

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

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

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

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

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

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

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

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

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

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 Tagged for AnyRef<'_>

fn tag(&self) -> Tag

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

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<AnyRef<'_>> for GeneralizedTime

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<AnyRef<'_>> for Null

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<AnyRef<'_>> for ObjectIdentifier

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<AnyRef<'_>> for UtcTime

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<AnyRef<'_>> for bool

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<AnyRef<'_>> for i128

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<AnyRef<'_>> for i16

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<AnyRef<'_>> for i32

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<AnyRef<'_>> for i64

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<AnyRef<'_>> for i8

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<AnyRef<'_>> for u128

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<AnyRef<'_>> for u16

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<AnyRef<'_>> for u32

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<AnyRef<'_>> for u64

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<AnyRef<'_>> for u8

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

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.

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

Performs the conversion.

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

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

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl ValueOrd for AnyRef<'_>

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.

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

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

impl<'a> StructuralEq for AnyRef<'a>

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