Enum webpki::SubjectNameRef

pub enum SubjectNameRef<'a> {
    DnsName(DnsNameRef<'a>),
    IpAddress(IpAddrRef<'a>),
}

A DNS name or IP address, which borrows its text representation.

Variants

DnsName(DnsNameRef<'a>)

A valid DNS name

IpAddress(IpAddrRef<'a>)

A valid IP address

Implementations

impl<'a> SubjectNameRef<'a>

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

Attempts to decode an encodingless string as either an IPv4 address, IPv6 address or DNS name; in that order. In practice this space is non-overlapping because DNS name components are separated by periods but cannot be wholly numeric (so cannot overlap with a valid IPv4 address), and IPv6 addresses are separated by colons but cannot contain periods.

The IPv6 address encoding supported here is extremely simplified; it does not support compression, all leading zeroes must be present in each 16-bit word, etc. Generally this is not suitable as a parse for human-provided addresses for this reason. Instead: consider parsing these with std::net::IpAddr and then using IpAddr::from<std::net::IpAddr>.

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

Constructs a SubjectNameRef from the given input if the input is a syntactically-valid DNS name or IP address.

Trait Implementations

impl AsRef<[u8]> for SubjectNameRef<'_>

fn as_ref(&self) -> &[u8]

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

impl<'a> Clone for SubjectNameRef<'a>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for SubjectNameRef<'a>

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

Formats the value using the given formatter.

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> From<IpAddrRef<'a>> for SubjectNameRef<'a>

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

Converts to this type from the input type.

impl<'a> Copy for SubjectNameRef<'a>