Struct RelativeOid 

pub struct RelativeOid { /* private fields */ }

ASN.1 RELATIVE-OID

A RELATIVE-OID is a sequence of integer components (arcs) that identifies an object relative to some other OID. Unlike OBJECT IDENTIFIER, a RELATIVE-OID can have any number of components (including zero) and does not apply special encoding to the first two components.

Uses SmallVec to avoid allocations for most RELATIVE-OIDs (< 10 components)

Implementations

impl RelativeOid

pub fn new(components: &[u32]) -> Self

Create a new RelativeOid from a slice of component integers.

Unlike OBJECT IDENTIFIER, RELATIVE-OID has no validation constraints on the component values or count. An empty RELATIVE-OID is valid.

Example

use synta::RelativeOid;

// Trust anchor ID suffix (e.g., "1" in "32473.1")
let roid = RelativeOid::new(&[1]);
assert_eq!(roid.to_string(), "1");

// Empty RELATIVE-OID is valid
let empty = RelativeOid::new(&[]);
assert_eq!(empty.to_string(), "");

pub fn components(&self) -> &[u32]

Return the RELATIVE-OID as a slice of component integers.

Example

use synta::RelativeOid;

let roid = RelativeOid::new(&[1, 2, 3]);
assert!(matches!(roid.components(), [1, 2, 3]));

pub fn from_content_bytes(data: &[u8]) -> Result<Self>

Parse a RELATIVE-OID from its DER/BER content bytes — the raw value bytes inside a RELATIVE-OID TLV, with the tag (0x0D) and length already stripped.

Errors

Returns Error::InvalidOid if data contains a truncated base-128 sequence or causes a u32 overflow in any component.

Example

use synta::RelativeOid;

// RELATIVE-OID with components [1, 2, 3]
let roid = RelativeOid::from_content_bytes(&[0x01, 0x02, 0x03]).unwrap();
assert_eq!(roid.to_string(), "1.2.3");

pub fn to_content_bytes(&self) -> Vec<u8>

Encode this RELATIVE-OID as DER content bytes — the raw base-128 arc bytes without the 0x0D tag byte or the length field.

This is the symmetric counterpart to from_content_bytes.

Example

use synta::RelativeOid;

let roid = RelativeOid::new(&[1, 2, 3]);
assert_eq!(roid.to_content_bytes(), &[0x01, 0x02, 0x03]);
// Round-trip
assert_eq!(RelativeOid::from_content_bytes(&roid.to_content_bytes()).unwrap(), roid);

Trait Implementations

impl Clone for RelativeOid

fn clone(&self) -> RelativeOid

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RelativeOid

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

Formats the value using the given formatter.

impl Decode<'_> for RelativeOid

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

Decode one ASN.1 value from decoder.

impl Display for RelativeOid

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

Formats the value using the given formatter.

impl Encode for RelativeOid

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

Encode this value as ASN.1 TLV bytes into encoder.

fn encoded_len(&self) -> Result<usize>

Return the number of bytes that encode will write.

impl Eq for RelativeOid

impl FromStr for RelativeOid

Available on crate feature std only.

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

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

impl PartialEq for RelativeOid

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RelativeOid

impl Tagged for RelativeOid

fn tag() -> Tag

Return the outermost ASN.1 tag for this type.