Struct openssl::asn1::Asn1StringRef

pub struct Asn1StringRef(_);

A reference to an Asn1String.

Implementations

impl Asn1StringRef

pub fn as_utf8(&self) -> Result<OpensslString, ErrorStack>

Converts the ASN.1 underlying format to UTF8

ASN.1 strings may utilize UTF-16, ASCII, BMP, or UTF8. This is important to consume the string in a meaningful way without knowing the underlying format.

This corresponds to ASN1_STRING_to_UTF8.

Examples found in repository

src/asn1.rs (line 476)

    fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self.as_utf8() {
            Ok(openssl_string) => openssl_string.fmt(fmt),
            Err(_) => fmt.write_str("error"),
        }
    }

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

Return the string as an array of bytes.

The bytes do not directly correspond to UTF-8 encoding. To interact with strings in rust, it is preferable to use as_utf8

This corresponds to ASN1_STRING_get0_data.

pub fn len(&self) -> usize

Returns the number of bytes in the string.

This corresponds to ASN1_STRING_length.

Examples found in repository

src/asn1.rs (line 459)

    pub fn as_slice(&self) -> &[u8] {
        unsafe { slice::from_raw_parts(ASN1_STRING_get0_data(self.as_ptr()), self.len()) }
    }

    /// Returns the number of bytes in the string.
    #[corresponds(ASN1_STRING_length)]
    pub fn len(&self) -> usize {
        unsafe { ffi::ASN1_STRING_length(self.as_ptr()) as usize }
    }

    /// Determines if the string is empty.
    pub fn is_empty(&self) -> bool {
        self.len() == 0
    }

pub fn is_empty(&self) -> bool

Determines if the string is empty.

Trait Implementations

impl AsRef<Asn1StringRef> for Asn1String

fn as_ref(&self) -> &Asn1StringRef

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

impl Borrow<Asn1StringRef> for Asn1String

fn borrow(&self) -> &Asn1StringRef

Immutably borrows from an owned value.

impl Debug for Asn1StringRef

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

Formats the value using the given formatter.

impl ForeignTypeRef for Asn1StringRef

type CType = ASN1_STRING

The raw C type.

unsafe fn from_ptr<'a>(ptr: *mut Self::CType) -> &'a Self

Constructs a shared instance of this type from its raw type.

unsafe fn from_ptr_mut<'a>(ptr: *mut Self::CType) -> &'a mut Self

Constructs a mutable reference of this type from its raw type.

fn as_ptr(&self) -> *mut Self::CType

Returns a raw pointer to the wrapped value.

impl Send for Asn1StringRef

impl Sync for Asn1StringRef