Struct der::ObjectIdentifier

pub struct ObjectIdentifier { /* fields omitted */ }

This is supported on crate feature oid only.

Object identifier (OID)

Implementations

impl ObjectIdentifier

pub const fn new(arcs: &[u32]) -> ObjectIdentifier

Create an ObjectIdentifier from a slice of integers, where each integer represents an "arc" (a.k.a. node) in the OID.

Panics

To enable const fn usage and work around current limitations thereof, this method panics in the event the OID is malformed.

For that reason this method is not recommended except for use in constants (where it will generate a compiler error instead). To parse an OID from a &[u32] slice without panicking on error, use TryFrom<&[u32]> instead.

In order for an OID to be valid, it must meet the following criteria:

• The OID MUST have at least 3 arcs
• The OID MUST NOT have more arcs than the MAX_ARCS constant
• The first arc MUST be within the range 0-2
• The second arc MUST be within the range 0-39

pub fn arc(&self, index: usize) -> Option<u32>

Return the arc with the given index, if it exists.

pub fn arcs(&self) -> Arcs

Iterate over the arcs (a.k.a. nodes) in an ObjectIdentifier.

Returns Arcs, an iterator over u32 values representing the value of each arc/node.

pub fn len(&self) -> usize

Number of arcs in this ObjectIdentifier.

pub fn from_ber(bytes: &[u8]) -> Result<ObjectIdentifier, Error>

Parse an OID from from its BER/DER encoding.

pub fn ber_len(&self) -> usize

Get the length of this OID when serialized as ASN.1 BER.

pub fn write_ber(&self, bytes: &'a mut [u8]) -> Result<&'a [u8], Error>

Write the BER encoding of this OID into the given slice, returning a new slice containing the written data.

Trait Implementations

impl Clone for ObjectIdentifier

pub fn clone(&self) -> ObjectIdentifier

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for ObjectIdentifier

impl Debug for ObjectIdentifier

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

Formats the value using the given formatter.

impl Display for ObjectIdentifier

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

Formats the value using the given formatter.

impl Encodable for ObjectIdentifier

pub fn encoded_len(&self) -> Result<Length>

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

pub fn encode(&self, encoder: &mut Encoder<'_>) -> Result<()>

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

pub 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.

pub 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.

pub fn to_vec(&self) -> Result<Vec<u8>>

This is supported on crate feature alloc only.

Serialize this message as a byte vector.

impl Eq for ObjectIdentifier

impl<'_> From<&'_ ObjectIdentifier> for ObjectIdentifier

pub fn from(oid: &ObjectIdentifier) -> ObjectIdentifier

Performs the conversion.

impl FromStr for ObjectIdentifier

type Err = Error

The associated error which can be returned from parsing.

pub fn from_str(s: &str) -> Result<ObjectIdentifier, Error>

Parses a string s to return a value of this type.

impl PartialEq<ObjectIdentifier> for ObjectIdentifier

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

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

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

This method tests for !=.

impl StructuralEq for ObjectIdentifier

impl StructuralPartialEq for ObjectIdentifier

impl<'a> Tagged for ObjectIdentifier

pub const TAG: Tag

ASN.1 tag

impl<'_> TryFrom<&'_ [u32]> for ObjectIdentifier

type Error = Error

The type returned in the event of a conversion error.

pub fn try_from(arcs: &[u32]) -> Result<ObjectIdentifier, Error>

Performs the conversion.

impl<'_> TryFrom<Any<'_>> for ObjectIdentifier

type Error = Error

The type returned in the event of a conversion error.

pub fn try_from(any: Any<'_>) -> Result<ObjectIdentifier>

Performs the conversion.