Struct webpki::DNSName

pub struct DNSName(_);

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 DNSName is guaranteed to be syntactically valid. The validity rules are specified in RFC 5280 Section 7.2, except that underscores are also allowed.

DNSName stores a copy of the input it was constructed from in a String and so it is only available when the std default feature is enabled.

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.

Methods

impl DNSName

pub fn as_ref(&self) -> DNSNameRef

Returns a DNSNameRef that refers to this DNSName.

Trait Implementations

impl PartialEq<DNSName> for DNSName

fn eq(&self, other: &DNSName) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &DNSName) -> bool

This method tests for !=.

impl Eq for DNSName

impl Hash for DNSName

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, 

Feeds a slice of this type into the given [Hasher].

impl Debug for DNSName

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

Formats the value using the given formatter.

impl AsRef<str> for DNSName

fn as_ref(&self) -> &str

Performs the conversion.

impl<'a> From<DNSNameRef<'a>> for DNSName

fn from(dns_name: DNSNameRef<'a>) -> Self

Performs the conversion.

impl Clone for DNSName

fn clone(&self) -> DNSName

Returns a copy of the value.

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

Performs copy-assignment from source.