Enum DirectoryString 

pub enum DirectoryString {
    PrintableString(PrintableString),
    TeletexString(TeletexString),
    Utf8String(String),
    BmpString(BmpString),
}

DirectoryString as defined in RFC 5280 Section 4.2.1.4.

ASN.1 structure for DirectoryString is below.

DirectoryString ::= CHOICE {
    teletexString           TeletexString (SIZE (1..MAX)),
    printableString         PrintableString (SIZE (1..MAX)),
    universalString         UniversalString (SIZE (1..MAX)),
    utf8String              UTF8String (SIZE (1..MAX)),
    bmpString               BMPString (SIZE (1..MAX))
}

Further, RFC 5280 Section 4.2.1.4 states:

The DirectoryString type is defined as a choice of PrintableString,
TeletexString, BMPString, UTF8String, and UniversalString.  CAs
conforming to this profile MUST use either the PrintableString or
UTF8String encoding of DirectoryString, with two exceptions.  When
CAs have previously issued certificates with issuer fields with
attributes encoded using TeletexString, BMPString, or
UniversalString, then the CA MAY continue to use these encodings of
the DirectoryString to preserve backward compatibility.  Also, new
CAs that are added to a domain where existing CAs issue certificates
with issuer fields with attributes encoded using TeletexString,
BMPString, or UniversalString MAY encode attributes that they share
with the existing CAs using the same encodings as the existing CAs
use.

The implication of the above paragraph is that PrintableString and UTF8String are the new types and the other types are legacy. Until the need arises, we only support PrintableString and UTF8String.

Variants

PrintableString(PrintableString)

TeletexString(TeletexString)

Utf8String(String)

BmpString(BmpString)

Implementations

impl DirectoryString

pub fn value(&self) -> Cow<'_, str>

Returns Borrowed variant for UTF-8 compatible strings and Owned variant otherwise.

pub fn as_ref(&self) -> &str

👎Deprecated since 0.3.0-pre.0:

use DirectoryString::value instead

Returns &str for PrintableString, TeletexString and Utf8String

Warning: Returns "" empty string for DirectoryString::BmpString variant

Trait Implementations

impl<'__der_lifetime> Choice<'__der_lifetime> for DirectoryString

fn can_decode(tag: Tag) -> bool

Is the provided Tag decodable as a variant of this CHOICE?

impl Clone for DirectoryString

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DirectoryString

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

Formats the value using the given formatter.

impl<'__der_lifetime> Decode<'__der_lifetime> for DirectoryString

type Error = Error

Type returned in the event of a decoding error.

fn decode<R: Reader<'__der_lifetime>>(reader: &mut R) -> Result<Self, Error>

Attempt to decode this TLV message using the provided decoder.

fn from_der(bytes: &'a [u8]) -> Result<Self, Self::Error>

Parse Self from the provided DER-encoded byte slice.

fn from_der_partial(bytes: &'a [u8]) -> Result<(Self, &'a [u8]), Self::Error>

Parse Self from the provided DER-encoded byte slice.

impl<'__der_lifetime> DecodeValue<'__der_lifetime> for DirectoryString

type Error = Error

Type returned in the event of a decoding error.

fn decode_value<R: Reader<'__der_lifetime>>( reader: &mut R, header: Header, ) -> Result<Self, Error>

Attempt to decode this value using the provided Reader.

impl<'__der_lifetime> EncodeValue for DirectoryString

fn encode_value(&self, encoder: &mut impl Writer) -> Result<()>

Encode value (sans [Tag]+Length header) as ASN.1 DER using the provided Writer.

fn value_len(&self) -> Result<Length>

Compute the length of this value (sans [Tag]+Length header) when encoded as ASN.1 DER.

fn header(&self) -> Result<Header, Error>

where Self: Tagged,

Get the Header used to encode this value.

impl Eq for DirectoryString

impl From<DirectoryString> for String

fn from(value: DirectoryString) -> Self

Converts to this type from the input type.

impl<'__der_lifetime> IsConstructed for DirectoryString

const CONSTRUCTED: bool = true

ASN.1 constructed bit

impl PartialEq for DirectoryString

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DirectoryString

impl<'__der_lifetime> Tagged for DirectoryString

fn tag(&self) -> Tag

Get the ASN.1 tag that this type is encoded with.

impl<'a> TryFrom<&'a Any> for DirectoryString

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: &'a Any) -> Result<Self>

Performs the conversion.

impl ValueOrd for DirectoryString

fn value_cmp(&self, other: &Self) -> Result<Ordering>

Return an Ordering between value portion of TLV-encoded self and other when serialized as ASN.1 DER.