Struct UniversalString

pub struct UniversalString(/* private fields */);

ASN.1 UniversalString type.

Examples

You can create a UniversalString from a literal string with UniversalString::try_from:

use rcgen::string::UniversalString;
let hello = UniversalString::try_from("hello").unwrap();

Supported characters

The characters which can appear in the UniversalString type are any of the characters allowed by ISO/IEC 10646 (Unicode).

Bytes are encoded like UTF-32 big-endian.

UniversalString is included for backward compatibility, RFC 5280 say it SHOULD NOT be used for certificates for new subjects.

Implementations

impl UniversalString

pub fn as_bytes(&self) -> &[u8]

Returns a byte slice of this UniversalString’s contents.

The inverse of this method is from_utf32be.

Examples

use rcgen::string::UniversalString;
let s = UniversalString::try_from("hello").unwrap();

assert_eq!(&[0, 0, 0, 104, 0, 0, 0, 101, 0, 0, 0, 108, 0, 0, 0, 108, 0, 0, 0, 111], s.as_bytes());

pub fn from_utf32be(vec: Vec<u8>) -> Result<UniversalString, Error>

Decode a UTF-32BE–encoded vector vec into a UniversalString, returning Err if vec contains any invalid data.

Trait Implementations

impl Clone for UniversalString

fn clone(&self) -> UniversalString

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UniversalString

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

Formats the value using the given formatter.

impl Hash for UniversalString

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for UniversalString

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl TryFrom<&str> for UniversalString

fn try_from( value: &str, ) -> Result<UniversalString, <UniversalString as TryFrom<&str>>::Error>

Converts a &str to a UniversalString.

Any character not in the UniversalString charset will be rejected. See UniversalString documentation for more information.

The result is allocated on the heap.

type Error = Error

The type returned in the event of a conversion error.

impl TryFrom<String> for UniversalString

fn try_from( value: String, ) -> Result<UniversalString, <UniversalString as TryFrom<String>>::Error>

Converts a String into a UniversalString

Any character not in the UniversalString charset will be rejected. See UniversalString documentation for more information.

Parsing a UniversalString allocates memory since the UTF-8 to UTF-32 conversion requires a memory allocation.

type Error = Error

The type returned in the event of a conversion error.

impl Eq for UniversalString

impl StructuralPartialEq for UniversalString