Struct TaggedValue

pub struct TaggedValue<T, TagKind, const CLASS: u8, const TAG: u32> { /* private fields */ }

Available on crate feature mtls only.

Helper object for creating FromBer/FromDer types for TAGGED OPTIONAL types

When parsing ContextSpecific (the most common class), see TaggedExplicit and TaggedImplicit alias types.

Notes

CLASS must be between 0 and 4. See Class for possible values for the CLASS parameter.

Examples

To parse a [APPLICATION 0] EXPLICIT INTEGER object:

use asn1_rs::{Explicit, FromBer, Integer, TaggedValue};

let bytes = &[0x60, 0x03, 0x2, 0x1, 0x2];

// If tagged object is present (and has expected tag), parsing succeeds:
let (_, tagged) = TaggedValue::<Integer, Explicit, 0b01, 0>::from_ber(bytes).unwrap();
assert_eq!(tagged, TaggedValue::explicit(Integer::from(2)));

Implementations

impl<T, TagKind, const CLASS: u8, const TAG: u32> TaggedValue<T, TagKind, CLASS, TAG>

pub fn into_inner(self) -> T

Consumes the TaggedParser, returning the wrapped value.

impl<T, const CLASS: u8, const TAG: u32> TaggedValue<T, Explicit, CLASS, TAG>

pub const fn explicit(inner: T) -> TaggedValue<T, Explicit, CLASS, TAG>

Constructs a new EXPLICIT TaggedParser with the provided value

impl<T, const CLASS: u8, const TAG: u32> TaggedValue<T, Implicit, CLASS, TAG>

pub const fn implicit(inner: T) -> TaggedValue<T, Implicit, CLASS, TAG>

Constructs a new IMPLICIT TaggedParser with the provided value

Trait Implementations

impl<T, TagKind, const CLASS: u8, const TAG: u32> AsRef<T> for TaggedValue<T, TagKind, CLASS, TAG>

fn as_ref(&self) -> &T

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

impl<'a, T, const CLASS: u8, const TAG: u32> CheckDerConstraints for TaggedValue<T, Explicit, CLASS, TAG>

where T: CheckDerConstraints,

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

impl<'a, T, const CLASS: u8, const TAG: u32> CheckDerConstraints for TaggedValue<T, Implicit, CLASS, TAG>

where T: CheckDerConstraints + Tagged,

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

impl<T, TagKind, const CLASS: u8, const TAG: u32> Debug for TaggedValue<T, TagKind, CLASS, TAG>

where T: Debug, TagKind: Debug,

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

Formats the value using the given formatter.

impl<T, TagKind, const CLASS: u8, const TAG: u32> PartialEq for TaggedValue<T, TagKind, CLASS, TAG>

where T: PartialEq, TagKind: PartialEq,

fn eq(&self, other: &TaggedValue<T, TagKind, CLASS, TAG>) -> 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<T, TagKind, const CLASS: u8, const TAG: u32> Tagged for TaggedValue<T, TagKind, CLASS, TAG>

const TAG: Tag = _

impl<T, const CLASS: u8, const TAG: u32> ToDer for TaggedValue<T, Explicit, CLASS, TAG>

where T: ToDer,

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

Get the length of the object, 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<T, const CLASS: u8, const TAG: u32> ToDer for TaggedValue<T, Implicit, CLASS, TAG>

where T: ToDer,

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

Get the length of the object, 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, T, const CLASS: u8, const TAG: u32> TryFrom<Any<'a>> for TaggedValue<T, Explicit, CLASS, TAG>

where T: FromBer<'a>,

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: Any<'a>) -> Result<TaggedValue<T, Explicit, CLASS, TAG>, Error>

Performs the conversion.

impl<'a, T, const CLASS: u8, const TAG: u32> TryFrom<Any<'a>> for TaggedValue<T, Implicit, CLASS, TAG>

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

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: Any<'a>) -> Result<TaggedValue<T, Implicit, CLASS, TAG>, Error>

Performs the conversion.

impl<T, TagKind, const CLASS: u8, const TAG: u32> StructuralPartialEq for TaggedValue<T, TagKind, CLASS, TAG>