pub struct ObjectIdentifier { /* private fields */ }
Expand description
Object identifier (OID).
OIDs are hierarchical structures consisting of “arcs”, i.e. integer identifiers.
§Validity
In order for an OID to be considered valid by this library, it must meet the following criteria:
- The OID MUST have at least 3 arcs
- The first arc MUST be within the range 0-2
- The second arc MUST be within the range 0-39
- The BER/DER encoding of the OID MUST be shorter than
ObjectIdentifier::MAX_SIZE
Implementations§
Source§impl ObjectIdentifier
impl ObjectIdentifier
Sourcepub const fn new_unwrap(s: &str) -> ObjectIdentifier
pub const fn new_unwrap(s: &str) -> ObjectIdentifier
Parse an ObjectIdentifier
from the dot-delimited string form,
panicking on parse errors.
This function exists as a workaround for unwrap
not yet being
stable in const fn
contexts, and is intended to allow the result to
be bound to a constant value:
use const_oid::ObjectIdentifier;
pub const MY_OID: ObjectIdentifier = ObjectIdentifier::new_unwrap("1.2.840.113549.1.1.1");
In future versions of Rust it should be possible to replace this with
ObjectIdentifier::new(...).unwrap()
.
Use ObjectIdentifier::new
for fallible parsing.
Sourcepub const fn new(s: &str) -> Result<ObjectIdentifier, Error>
pub const fn new(s: &str) -> Result<ObjectIdentifier, Error>
Parse an ObjectIdentifier
from the dot-delimited string form.
Sourcepub fn from_arcs(
arcs: impl IntoIterator<Item = u32>,
) -> Result<ObjectIdentifier, Error>
pub fn from_arcs( arcs: impl IntoIterator<Item = u32>, ) -> Result<ObjectIdentifier, Error>
Parse an OID from a slice of Arc
values (i.e. integers).
Sourcepub fn from_bytes(ber_bytes: &[u8]) -> Result<ObjectIdentifier, Error>
pub fn from_bytes(ber_bytes: &[u8]) -> Result<ObjectIdentifier, Error>
Parse an OID from from its BER/DER encoding.
Sourcepub fn as_bytes(&self) -> &[u8]
pub fn as_bytes(&self) -> &[u8]
Get the BER/DER serialization of this OID as bytes.
Note that this encoding omits the tag/length, and only contains the value portion of the encoded OID.
Sourcepub fn arc(&self, index: usize) -> Option<u32>
pub fn arc(&self, index: usize) -> Option<u32>
Return the arc with the given index, if it exists.
Sourcepub fn arcs(&self) -> Arcs<'_>
pub fn arcs(&self) -> Arcs<'_>
Iterate over the arcs (a.k.a. nodes) of an ObjectIdentifier
.
Sourcepub fn len(&self) -> usize
pub fn len(&self) -> usize
Get the length of this ObjectIdentifier
in arcs.
Sourcepub fn parent(&self) -> Option<ObjectIdentifier>
pub fn parent(&self) -> Option<ObjectIdentifier>
Get the parent OID of this one (if applicable).
Trait Implementations§
Source§impl AsRef<[u8]> for ObjectIdentifier
impl AsRef<[u8]> for ObjectIdentifier
Source§impl Clone for ObjectIdentifier
impl Clone for ObjectIdentifier
Source§fn clone(&self) -> ObjectIdentifier
fn clone(&self) -> ObjectIdentifier
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source
. Read moreSource§impl Debug for ObjectIdentifier
impl Debug for ObjectIdentifier
Source§impl<'a> DecodeValue<'a> for ObjectIdentifier
impl<'a> DecodeValue<'a> for ObjectIdentifier
Source§impl Display for ObjectIdentifier
impl Display for ObjectIdentifier
Source§impl EncodeValue for ObjectIdentifier
impl EncodeValue for ObjectIdentifier
Source§impl<'a> From<&'a ObjectIdentifier> for AnyRef<'a>
impl<'a> From<&'a ObjectIdentifier> for AnyRef<'a>
Source§fn from(oid: &'a ObjectIdentifier) -> AnyRef<'a>
fn from(oid: &'a ObjectIdentifier) -> AnyRef<'a>
Source§impl From<&ObjectIdentifier> for ObjectIdentifier
impl From<&ObjectIdentifier> for ObjectIdentifier
Source§fn from(oid: &ObjectIdentifier) -> ObjectIdentifier
fn from(oid: &ObjectIdentifier) -> ObjectIdentifier
Source§impl FromStr for ObjectIdentifier
impl FromStr for ObjectIdentifier
Source§impl Hash for ObjectIdentifier
impl Hash for ObjectIdentifier
Source§impl Ord for ObjectIdentifier
impl Ord for ObjectIdentifier
Source§fn cmp(&self, other: &ObjectIdentifier) -> Ordering
fn cmp(&self, other: &ObjectIdentifier) -> Ordering
1.21.0 · Source§fn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere
Self: Sized,
Source§impl PartialEq for ObjectIdentifier
impl PartialEq for ObjectIdentifier
Source§impl PartialOrd for ObjectIdentifier
impl PartialOrd for ObjectIdentifier
Source§impl TryFrom<&[u8]> for ObjectIdentifier
impl TryFrom<&[u8]> for ObjectIdentifier
Source§impl TryFrom<AnyRef<'_>> for ObjectIdentifier
impl TryFrom<AnyRef<'_>> for ObjectIdentifier
impl Copy for ObjectIdentifier
impl Eq for ObjectIdentifier
impl StructuralPartialEq for ObjectIdentifier
Auto Trait Implementations§
impl Freeze for ObjectIdentifier
impl RefUnwindSafe for ObjectIdentifier
impl Send for ObjectIdentifier
impl Sync for ObjectIdentifier
impl Unpin for ObjectIdentifier
impl UnwindSafe for ObjectIdentifier
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§unsafe fn clone_to_uninit(&self, dst: *mut T)
unsafe fn clone_to_uninit(&self, dst: *mut T)
clone_to_uninit
)Source§impl<'a, T> Decode<'a> for Twhere
T: DecodeValue<'a> + FixedTag,
impl<'a, T> Decode<'a> for Twhere
T: DecodeValue<'a> + FixedTag,
Source§impl<T> Encode for Twhere
T: EncodeValue + Tagged,
impl<T> Encode for Twhere
T: EncodeValue + Tagged,
Source§fn encoded_len(&self) -> Result<Length, Error>
fn encoded_len(&self) -> Result<Length, Error>
Compute the length of this value in bytes when encoded as ASN.1 DER.
Source§fn encode(&self, writer: &mut dyn Writer) -> Result<(), Error>
fn encode(&self, writer: &mut dyn Writer) -> Result<(), Error>
Encode this value as ASN.1 DER using the provided Writer
.