Struct DnsName 

pub struct DnsName<'a>(/* private fields */);

Available on crate feature crypto only.

A type which encapsulates a string (borrowed or owned) that is a syntactically valid DNS name.

Implementations

impl<'a> DnsName<'a>

pub fn borrow(&'a self) -> DnsName<'a>

Available on (crate features rustls or boring or acme) and crate feature rustls only.

Produce a borrowed DnsName from this owned DnsName.

pub fn to_lowercase_owned(&self) -> DnsName<'static>

Available on (crate features rustls or boring or acme) and crate feature rustls and crate feature alloc only.

Copy this object to produce an owned DnsName, smashing the case to lowercase in one operation.

pub fn to_owned(&self) -> DnsName<'static>

Available on (crate features rustls or boring or acme) and crate feature rustls and crate feature alloc only.

Produce an owned DnsName from this (potentially borrowed) DnsName.

pub const fn try_from_str(s: &str) -> Result<DnsName<'_>, InvalidDnsNameError>

Available on (crate features rustls or boring or acme) and crate feature rustls only.

Produces a borrowed DnsName from a borrowed [str].

Trait Implementations

impl AsRef<str> for DnsName<'_>

fn as_ref(&self) -> &str

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

impl<'a> Clone for DnsName<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for DnsName<'a>

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

Formats the value using the given formatter.

impl<'a> From<DnsName<'a>> for ServerName<'a>

fn from(dns_name: DnsName<'a>) -> ServerName<'a>

Converts to this type from the input type.

impl<'a> Hash for DnsName<'a>

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<'a> PartialEq for DnsName<'a>

fn eq(&self, other: &DnsName<'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> TryFrom<&'a [u8]> for DnsName<'a>

type Error = InvalidDnsNameError

The type returned in the event of a conversion error.

fn try_from( value: &'a [u8], ) -> Result<DnsName<'a>, <DnsName<'a> as TryFrom<&'a [u8]>>::Error>

Performs the conversion.

impl<'a> TryFrom<&'a str> for DnsName<'a>

type Error = InvalidDnsNameError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl TryFrom<String> for DnsName<'static>

Available on crate feature alloc only.

type Error = InvalidDnsNameError

The type returned in the event of a conversion error.

fn try_from( value: String, ) -> Result<DnsName<'static>, <DnsName<'static> as TryFrom<String>>::Error>

Performs the conversion.

impl<'a> Eq for DnsName<'a>

impl<'a> StructuralPartialEq for DnsName<'a>