Struct webpki::subject_name::dns_name::WildcardDnsNameRef

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

A reference to a DNS Name presented by a server that may include a wildcard.

A WildcardDnsNameRef is guaranteed to be syntactically valid. The validity rules are specified in RFC 5280 Section 7.2, except that underscores are also allowed.

Additionally, while [RFC6125 Section 4.1] says that a wildcard label may be of the form <x>*<y>.<DNSID>, where <x> and/or <y> may be empty, we follow a stricter policy common to most validation libraries (e.g. NSS) and only accept wildcard labels that are exactly *.

Tuple Fields

0: &'a [u8]

Implementations

impl<'a> WildcardDnsNameRef<'a>

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

Constructs a WildcardDnsNameRef 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 WildcardDnsNameRef from the given input if the input is a syntactically-valid DNS name.

Trait Implementations

impl AsRef<str> for WildcardDnsNameRef<'_>

fn as_ref(&self) -> &str

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

impl<'a> Clone for WildcardDnsNameRef<'a>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for WildcardDnsNameRef<'_>

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

Formats the value using the given formatter.

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

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

Converts to this type from the input type.

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

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

impl<'a> Eq for WildcardDnsNameRef<'a>

impl<'a> StructuralPartialEq for WildcardDnsNameRef<'a>