Struct webpki::DnsNameRef

source ·
pub struct DnsNameRef<'a>(/* private fields */);
Expand description

A reference to a DNS Name suitable for use in the TLS Server Name Indication (SNI) extension and/or for use as the reference hostname for which to verify a certificate.

A DnsNameRef is guaranteed to be syntactically valid. The validity rules are specified in RFC 5280 Section 7.2, except that underscores are also allowed.

Eq, PartialEq, etc. are not implemented because name comparison frequently should be done case-insensitively and/or with other caveats that depend on the specific circumstances in which the comparison is done.

Implementations§

source§

impl<'a> DnsNameRef<'a>

source

pub fn try_from_ascii(dns_name: &'a [u8]) -> Result<Self, InvalidDnsNameError>

Constructs a DnsNameRef from the given input if the input is a syntactically-valid DNS name.

source

pub fn try_from_ascii_str( dns_name: &'a str ) -> Result<Self, InvalidDnsNameError>

Constructs a DnsNameRef from the given input if the input is a syntactically-valid DNS name.

source

pub fn to_owned(&self) -> DnsName

Constructs a DnsName from this DnsNameRef

Requires the alloc feature.

Trait Implementations§

source§

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

source§

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

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

impl<'a> Clone for DnsNameRef<'a>

source§

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

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for DnsNameRef<'_>

Requires the alloc feature.

source§

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

Formats the value using the given formatter. Read more
source§

impl From<DnsNameRef<'_>> for DnsName

Requires the alloc feature.

source§

fn from(dns_name: DnsNameRef<'_>) -> Self

Converts to this type from the input type.
source§

impl<'a> From<DnsNameRef<'a>> for &'a str

source§

fn from(DnsNameRef: DnsNameRef<'a>) -> Self

Converts to this type from the input type.
source§

impl<'a> Copy for DnsNameRef<'a>

Auto Trait Implementations§

§

impl<'a> RefUnwindSafe for DnsNameRef<'a>

§

impl<'a> Send for DnsNameRef<'a>

§

impl<'a> Sync for DnsNameRef<'a>

§

impl<'a> Unpin for DnsNameRef<'a>

§

impl<'a> UnwindSafe for DnsNameRef<'a>

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for Twhere T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.