Enum ASN1Block

pub enum ASN1Block {
    Boolean(usize, bool),
    Integer(usize, BigInt),
    BitString(usize, usize, Vec<u8>),
    OctetString(usize, Vec<u8>),
    Null(usize),
    ObjectIdentifier(usize, OID),
    UTF8String(usize, String),
    PrintableString(usize, String),
    TeletexString(usize, String),
    IA5String(usize, String),
    UTCTime(usize, PrimitiveDateTime),
    GeneralizedTime(usize, PrimitiveDateTime),
    UniversalString(usize, String),
    BMPString(usize, String),
    Sequence(usize, Vec<ASN1Block>),
    Set(usize, Vec<ASN1Block>),
    Explicit(ASN1Class, usize, BigUint, Box<ASN1Block>),
    Unknown(ASN1Class, bool, usize, BigUint, Vec<u8>),
}

A primitive block from ASN.1.

Primitive blocks all contain the offset from the beginning of the parsed document, followed by whatever data is associated with the block. The latter should be fairly self-explanatory, so let’s discuss the offset.

The offset is only valid during the reading process. It is ignored for the purposes of encoding blocks into their binary form. It is also ignored for the purpose of comparisons via ==. It is included entirely to support the parsing of things like X509 certificates, in which it is necessary to know when particular blocks end.

The ASN1Class of explicitly tagged blocks is either Application, ContextSpecific or Private. Unknown can have any class. The class of all other variants is Universal.

Variants

Boolean(usize, bool)

Integer(usize, BigInt)

BitString(usize, usize, Vec<u8>)

OctetString(usize, Vec<u8>)

Null(usize)

ObjectIdentifier(usize, OID)

UTF8String(usize, String)

PrintableString(usize, String)

TeletexString(usize, String)

IA5String(usize, String)

UTCTime(usize, PrimitiveDateTime)

GeneralizedTime(usize, PrimitiveDateTime)

UniversalString(usize, String)

BMPString(usize, String)

Sequence(usize, Vec<ASN1Block>)

Set(usize, Vec<ASN1Block>)

Explicit(ASN1Class, usize, BigUint, Box<ASN1Block>)

An explicitly tagged block.

The class can be either Application, ContextSpecific or Private. The other parameters are offset, tag and content.

This block is always constructed.

Unknown(ASN1Class, bool, usize, BigUint, Vec<u8>)

An unkown block.

The parameters are class, constructed, offset, tag and content.

Implementations

impl ASN1Block

pub fn class(&self) -> ASN1Class

Get the class associated with the given ASN1Block, regardless of what kind of block it is.

pub fn offset(&self) -> usize

Get the starting offset associated with the given ASN1Block, regardless of what kind of block it is.

Trait Implementations

impl Clone for ASN1Block

fn clone(&self) -> ASN1Block

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ASN1Block

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

Formats the value using the given formatter.

impl PartialEq for ASN1Block

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