Struct webpki::DnsNameRef

pub struct DnsNameRef<'a>(pub(crate) &'a [u8]);

A reference to 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 DnsNameRef is guaranteed to be syntactically valid. The validity rules are specified in RFC 5280 Section 7.2, except that underscores are also allowed. DnsNameRefs do not include wildcard labels.

Tuple Fields

0: &'a [u8]

Implementations

impl<'a> DnsNameRef<'a>

pub fn try_from_ascii(dns_name: &'a [u8]) -> Result<Self, InvalidDnsNameError>

Constructs a DnsNameRef from the given input if the input is a syntactically-valid DNS name.

pub fn try_from_ascii_str( dns_name: &'a str, ) -> Result<Self, InvalidDnsNameError>

Constructs a DnsNameRef from the given input if the input is a syntactically-valid DNS name.

pub fn to_owned(&self) -> DnsName

Constructs a DnsName from this DnsNameRef

Trait Implementations

impl AsRef<str> for DnsNameRef<'_>

fn as_ref(&self) -> &str

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

impl<'a> Clone for DnsNameRef<'a>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DnsNameRef<'_>

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

Formats the value using the given formatter.

impl<'a> From<DnsNameRef<'a>> for &'a str

fn from(DnsNameRef: DnsNameRef<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<DnsNameRef<'a>> for SubjectNameRef<'a>

fn from(dns_name: DnsNameRef<'a>) -> SubjectNameRef<'_>

Converts to this type from the input type.

impl<'a> Hash for DnsNameRef<'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 DnsNameRef<'a>

fn eq(&self, other: &DnsNameRef<'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> Copy for DnsNameRef<'a>

impl<'a> Eq for DnsNameRef<'a>

impl<'a> StructuralPartialEq for DnsNameRef<'a>