Struct Utf8StringRef

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

ASN.1 UTF8String type.

Supports the full UTF-8 encoding.

Note that the Decode and Encode traits are impl’d for Rust’s str primitive, which decodes/encodes as a Utf8StringRef.

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 PrintableStringRef.

This is a zero-copy reference type which borrows from the input data.

Implementations

impl<'a> Utf8StringRef<'a>

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

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

Create a new ASN.1 UTF8String.

Trait Implementations

impl<'a> AsRef<[u8]> for Utf8StringRef<'a>

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

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

impl<'a> AsRef<str> for Utf8StringRef<'a>

fn as_ref(&self) -> &str

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

impl<'a> Clone for Utf8StringRef<'a>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Utf8StringRef<'a>

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

Formats the value using the given formatter.

impl<'__der: 'a, 'a> DecodeValue<'__der> for Utf8StringRef<'a>

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

Attempt to decode this message using the provided Reader.

impl<'a> Deref for Utf8StringRef<'a>

type Target = StrRef<'a>

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<'a> Display for Utf8StringRef<'a>

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

Formats the value using the given formatter.

impl<'a> EncodeValue for Utf8StringRef<'a>

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, writer: &mut impl Writer) -> Result<()>

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

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

where Self: Tagged,

Get the Header used to encode this value.

impl FixedTag for Utf8StringRef<'_>

const TAG: Tag = Tag::Utf8String

ASN.1 tag

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

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

Converts to this type from the input type.

impl<'a> From<Utf8StringRef<'a>> for AnyRef<'a>

fn from(utf_string: Utf8StringRef<'a>) -> AnyRef<'a>

Converts to this type from the input type.

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

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

Converts to this type from the input type.

impl<'a> Ord for Utf8StringRef<'a>

fn cmp(&self, other: &Utf8StringRef<'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,

Restrict a value to a certain interval.

impl<'a> PartialEq for Utf8StringRef<'a>

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

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

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl<'__der: 'a, 'a> TryFrom<&'__der Any> for Utf8StringRef<'a>

type Error = Error

The type returned in the event of a conversion error.

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

Performs the conversion.

impl<'__der: 'a, 'a> TryFrom<AnyRef<'__der>> for Utf8StringRef<'a>

type Error = Error

The type returned in the event of a conversion error.

fn try_from(any: AnyRef<'__der>) -> Result<Utf8StringRef<'a>>

Performs the conversion.

impl<'a> Copy for Utf8StringRef<'a>

impl<'a> Eq for Utf8StringRef<'a>

impl<'a> StructuralPartialEq for Utf8StringRef<'a>