Struct der::asn1::Utf8String

pub struct Utf8String<'a> { /* private fields */ }

ASN.1 UTF8String type.

Supports the full UTF-8 encoding.

Note that the Decodable and Encodable traits are impl’d for Rust’s str primitive, which decodes/encodes as a Utf8String.

You are free to use str instead of this type, however it’s still provided for explicitness in cases where it might be ambiguous with other ASN.1 string encodings such as PrintableString.

Implementations

impl<'a> Utf8String<'a>

pub fn new<T>(input: &'a T) -> Result<Self>

where T: AsRef<[u8]> + ?Sized,

Create a new ASN.1 UTF8String.

pub fn as_str(&self) -> &'a str

Borrow the string as a str.

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

Borrow the string as bytes.

pub fn len(&self) -> Length

Get the length of the inner byte slice.

pub fn is_empty(&self) -> bool

Is the inner string empty?

Trait Implementations

impl AsRef<[u8]> for Utf8String<'_>

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<str> for Utf8String<'_>

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl<'a> Clone for Utf8String<'a>

fn clone(&self) -> Utf8String<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Utf8String<'a>

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

Formats the value using the given formatter.

impl<'a> DecodeValue<'a> for Utf8String<'a>

fn decode_value(decoder: &mut Decoder<'a>, length: Length) -> Result<Self>

Attempt to decode this message using the provided Decoder.

impl<'a> Display for Utf8String<'a>

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

Formats the value using the given formatter.

impl EncodeValue for Utf8String<'_>

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

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

fn encode_value(&self, encoder: &mut Encoder<'_>) -> Result<()>

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

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

where Self: Tagged,

Get the Header used to encode this value.

impl FixedTag for Utf8String<'_>

const TAG: Tag = Tag::Utf8String

ASN.1 tag

impl<'a> From<&Utf8String<'a>> for Utf8String<'a>

fn from(value: &Utf8String<'a>) -> Utf8String<'a>

Converts to this type from the input type.

impl<'a> From<Utf8String<'a>> for &'a [u8]

fn from(utf8_string: Utf8String<'a>) -> &'a [u8]

Converts to this type from the input type.

impl<'a> From<Utf8String<'a>> for Any<'a>

fn from(printable_string: Utf8String<'a>) -> Any<'a>

Converts to this type from the input type.

impl<'a> From<Utf8String<'a>> for String

fn from(s: Utf8String<'a>) -> String

Converts to this type from the input type.

impl<'a> Ord for Utf8String<'a>

fn cmp(&self, other: &Utf8String<'a>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl<'a> PartialEq for Utf8String<'a>

fn eq(&self, other: &Utf8String<'a>) -> 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<'a> PartialOrd for Utf8String<'a>

fn partial_cmp(&self, other: &Utf8String<'a>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'a> TryFrom<Any<'a>> for Utf8String<'a>

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl<'a> Copy for Utf8String<'a>

impl<'a> Eq for Utf8String<'a>

impl OrdIsValueOrd for Utf8String<'_>

impl<'a> StructuralEq for Utf8String<'a>

impl<'a> StructuralPartialEq for Utf8String<'a>