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.

Implementations

impl DNSName

pub fn as_ref(&self) -> DNSNameRef<'_>

Returns a DNSNameRef that refers to this DNSName.

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 Clone for DNSName

fn clone(&self) -> DNSName

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DNSName

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

Formats the value using the given formatter.

impl From<DNSNameRef<'_>> for DNSName

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

Converts to this type from the input type.

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 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 ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for DNSName

impl StructuralEq for DNSName

impl StructuralPartialEq for DNSName