Enum der::Tag

#[non_exhaustive]
pub enum Tag {
    Boolean,
    Integer,
    BitString,
    OctetString,
    Null,
    ObjectIdentifier,
    Utf8String,
    Sequence,
    Set,
    PrintableString,
    Ia5String,
    UtcTime,
    GeneralizedTime,
    Application(TagNumber),
    ContextSpecific(TagNumber),
    Private(TagNumber),
}

ASN.1 tags.

Tags are the leading identifier octet of the Tag-Length-Value encoding used by ASN.1 DER and identify the type of the subsequent value.

They are described in X.690 Section 8.1.2: Identifier octets, and structured as follows:

| Class | P/C | Tag Number |

• Bits 8/7: Class
• Bit 6: primitive (0) or constructed (1)
• Bits 5-1: tag number

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Boolean

BOOLEAN tag: 0x01

Integer

INTEGER tag: 0x02

BitString

BIT STRING tag: 0x03

OctetString

OCTET STRING tag: 0x04

Null

NULL tag: 0x05

ObjectIdentifier

OBJECT IDENTIFIER tag: 0x06

Utf8String

UTF8String tag: 0x0C

Sequence

SEQUENCE tag: 0x10

Set

SET and SET OF tag: 0x11

PrintableString

PrintableString tag: 0x13

Ia5String

IA5String tag: 0x16

UtcTime

UTCTime tag: 0x17

GeneralizedTime

GeneralizedTime tag: 0x18

Application(TagNumber)

Application tag.

Tuple Fields of Application

0: TagNumber

ContextSpecific(TagNumber)

Context-specific tag.

Tuple Fields of ContextSpecific

0: TagNumber

Private(TagNumber)

Private tag number.

Tuple Fields of Private

0: TagNumber

Implementations

impl Tag

pub fn assert_eq(self, expected: Tag) -> Result<Tag>

Assert that this Tag matches the provided expected tag.

On mismatch, returns an Error with ErrorKind::UnexpectedTag.

pub fn class(self) -> Class

Get the Class that corresponds to this Tag.

pub fn octet(self) -> u8

Get the octet encoding for this Tag.

pub fn non_canonical_error(self) -> Error

Create an Error for an non-canonical value with the ASN.1 type identified by this tag.

pub fn unexpected_error(self, expected: Option<Self>) -> Error

Create an Error because the current tag was unexpected, with an optional expected tag.

pub fn value_error(self) -> Error

Create an Error for an invalid value with the ASN.1 type identified by this tag.

Trait Implementations

impl Clone for Tag

fn clone(&self) -> Tag

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Tag

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

Formats the value using the given formatter.

impl Decodable<'_> for Tag

fn decode(decoder: &mut Decoder<'_>) -> Result<Self>

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 Display for Tag

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

Formats the value using the given formatter.

impl Encodable for Tag

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 From<&'_ Tag> for u8

fn from(tag: &Tag) -> u8

Performs the conversion.

impl From<Tag> for u8

fn from(tag: Tag) -> u8

Performs the conversion.

impl Ord for Tag

fn cmp(&self, other: &Tag) -> Ordering

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

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

Restrict a value to a certain interval.

impl PartialEq<Tag> for Tag

fn eq(&self, other: &Tag) -> bool

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

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

This method tests for !=.

impl PartialOrd<Tag> for Tag

fn partial_cmp(&self, other: &Tag) -> 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 TryFrom<u8> for Tag

type Error = Error

The type returned in the event of a conversion error.

fn try_from(byte: u8) -> Result<Tag>

Performs the conversion.

impl Copy for Tag

impl Eq for Tag

impl StructuralEq for Tag

impl StructuralPartialEq for Tag