Struct webpki::DnsName

pub struct DnsName(_);

Requires the alloc feature. 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.

Requires the alloc feature.

Implementations

impl DnsName

Requires the alloc feature.

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

Returns a DnsNameRef that refers to this DnsName.

Trait Implementations

impl AsRef<str> for DnsName

Requires the alloc feature.

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.

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

Requires the alloc feature.

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

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

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