pub struct ContextSpecific<T> {
    pub tag_number: TagNumber,
    pub tag_mode: TagMode,
    pub value: T,
}
Available on crate feature pkcs8 only.
Expand description

Context-specific field which wraps an owned inner value.

This type decodes/encodes a field which is specific to a particular context and is identified by a TagNumber.

Fields§

§tag_number: TagNumber

Context-specific tag number sans the leading 0b10000000 class identifier bit and 0b100000 constructed flag.

§tag_mode: TagMode

Tag mode: EXPLICIT VS IMPLICIT.

§value: T

Value of the field.

Implementations§

§

impl<T> ContextSpecific<T>

pub fn decode_explicit<'a, R>( reader: &mut R, tag_number: TagNumber ) -> Result<Option<ContextSpecific<T>>, Error>
where R: Reader<'a>, T: Decode<'a>,

Attempt to decode an EXPLICIT ASN.1 CONTEXT-SPECIFIC field with the provided TagNumber.

This method has the following behavior which is designed to simplify handling of extension fields, which are denoted in an ASN.1 schema using the ... ellipsis extension marker:

  • Skips over ContextSpecific fields with a tag number lower than the current one, consuming and ignoring them.
  • Returns Ok(None) if a ContextSpecific field with a higher tag number is encountered. These fields are not consumed in this case, allowing a field with a lower tag number to be omitted, then the higher numbered field consumed as a follow-up.
  • Returns Ok(None) if anything other than a ContextSpecific field is encountered.

pub fn decode_implicit<'a, R>( reader: &mut R, tag_number: TagNumber ) -> Result<Option<ContextSpecific<T>>, Error>
where R: Reader<'a>, T: DecodeValue<'a> + Tagged,

Attempt to decode an IMPLICIT ASN.1 CONTEXT-SPECIFIC field with the provided TagNumber.

This method otherwise behaves the same as decode_explicit, but should be used in cases where the particular fields are IMPLICIT as opposed to EXPLICIT.

Trait Implementations§

§

impl<'a, T> Choice<'a> for ContextSpecific<T>
where T: Decode<'a> + Tagged,

§

fn can_decode(tag: Tag) -> bool

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

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

§

fn clone(&self) -> ContextSpecific<T>

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
§

impl<T> Debug for ContextSpecific<T>
where T: Debug,

§

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

Formats the value using the given formatter. Read more
§

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

§

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

Attempt to decode this message using the provided decoder.
§

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

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

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

§

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

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

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

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

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

Get the Header used to encode this value.
§

impl<T> Ord for ContextSpecific<T>
where T: Ord,

§

fn cmp(&self, other: &ContextSpecific<T>) -> 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
§

impl<T> PartialEq for ContextSpecific<T>
where T: PartialEq,

§

fn eq(&self, other: &ContextSpecific<T>) -> 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.
§

impl<T> PartialOrd for ContextSpecific<T>
where T: PartialOrd,

§

fn partial_cmp(&self, other: &ContextSpecific<T>) -> 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
§

impl<T> Tagged for ContextSpecific<T>
where T: Tagged,

§

fn tag(&self) -> Tag

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

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>, Error>

Performs the conversion.
§

impl<T> ValueOrd for ContextSpecific<T>

§

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

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

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

§

impl<T> Eq for ContextSpecific<T>
where T: Eq,

§

impl<T> StructuralPartialEq for ContextSpecific<T>

Auto Trait Implementations§

§

impl<T> RefUnwindSafe for ContextSpecific<T>
where T: RefUnwindSafe,

§

impl<T> Send for ContextSpecific<T>
where T: Send,

§

impl<T> Sync for ContextSpecific<T>
where T: Sync,

§

impl<T> Unpin for ContextSpecific<T>
where T: Unpin,

§

impl<T> UnwindSafe for ContextSpecific<T>
where T: UnwindSafe,

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
§

impl<T> DerOrd for T

§

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

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

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

§

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

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

§

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

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

§

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

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, Error>

Available on crate feature alloc only.
Encode this message as ASN.1 DER, appending it to the provided byte vector.
§

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

Available on crate feature alloc only.
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> Same for T

§

type Output = T

Should always be Self
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.
§

impl<T> DecodeOwned for T
where T: for<'a> Decode<'a>,