Struct DnsName

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

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) -> Self

Produce a borrowed DnsName from this owned DnsName.

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

Available on 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 feature alloc only.

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

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

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 copy 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

Formats the value using the given formatter.

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

fn hash<__H: Hasher>(&self, state: &mut __H)

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<Self, Self::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<Self, Self::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<Self, Self::Error>

Performs the conversion.

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

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

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 24 bytes