Struct rcgen::DistinguishedName

pub struct DistinguishedName { /* private fields */ }

Distinguished name used e.g. for the issuer and subject fields of a certificate

A distinguished name is a set of (attribute type, attribute value) tuples.

This datastructure keeps them ordered by insertion order.

See also the RFC 5280 sections on the issuer and subject fields.

Implementations

impl DistinguishedName

pub fn new() -> Self

Creates a new, empty distinguished name

pub fn get(&self, ty: &DnType) -> Option<&DnValue>

Obtains the attribute value for the given attribute type

pub fn remove(&mut self, ty: DnType) -> bool

Removes the attribute with the specified DnType

Returns true when an actual removal happened, false when no attribute with the specified DnType was found.

pub fn push(&mut self, ty: DnType, s: impl Into<DnValue>)

Inserts or updates an attribute that consists of type and name

let mut dn = DistinguishedName::new();
dn.push(DnType::OrganizationName, "Crab widgits SE");
dn.push(DnType::CommonName, DnValue::PrintableString("Master Cert".to_string()));
assert_eq!(dn.get(&DnType::OrganizationName), Some(&DnValue::Utf8String("Crab widgits SE".to_string())));
assert_eq!(dn.get(&DnType::CommonName), Some(&DnValue::PrintableString("Master Cert".to_string())));

pub fn iter(&self) -> DistinguishedNameIterator<'_>

Iterate over the entries

Trait Implementations

impl Clone for DistinguishedName

fn clone(&self) -> DistinguishedName

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DistinguishedName

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

Formats the value using the given formatter.

impl PartialEq for DistinguishedName

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

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for DistinguishedName

impl StructuralEq for DistinguishedName

impl StructuralPartialEq for DistinguishedName