Struct Oid 

pub struct Oid<'a>(/* private fields */);

An object identifier, as the arcs are encoded, without the tag or length.

Held encoded rather than decoded because identity is the encoding: two identifiers are the same one when their bytes match, and comparing rendered text instead would make 1.2.840.113549 and a lookalike written with an arc padded to the same digits into the same identifier.

Implementations

impl<'a> Oid<'a>

pub const fn from_bytes(bytes: &'a [u8]) -> Self

An identifier from written-out bytes, validated as it is built.

For the constants a schema names. The same rules the document reader enforces are held here by construction, so a table entry cannot name something no document could: a malformed constant fails the build during constant evaluation, and a malformed runtime call panics at the constructor rather than printing nonsense later. Document bytes never come through here; the parser validates them.

Panics

When the bytes are not a well formed object identifier: empty, a padded arc, or a truncated continuation. Width is not among them, as it is not for a document: the encoding bounds no subidentifier (X.690 8.19.2).

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

The encoded arcs.

pub fn text(self, execution: &Memory) -> Result<OwnedString, MemoryError>

Exact dotted-decimal text, admitting conversion work and storage in the current execution domain. The result retains its capacity charge. Width is unrestricted by ASN.1; insufficient resources return an error.

pub fn arcs(self) -> Arcs<'a>

The arcs, root first.

Constructing the iterator is constant work. Advancing it scans the encoded groups of one subidentifier; the caller must admit that work when iterating untrusted input. Self::text accounts for its traversal.

Trait Implementations

impl<'a> Clone for Oid<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for Oid<'a>

impl<'a> Debug for Oid<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for Oid<'a>

impl<'a> Hash for Oid<'a>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl HashWork for Oid<'_>

fn hash_work(&self) -> Result<u64, MemoryError>

Work units for one hash/equality traversal, including constant overhead.

impl<'a> PartialEq for Oid<'a>

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

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for Oid<'a>