Enum Host 

pub enum Host {
    Name(HostName),
    Ip(IpAddr),
}

The host part of a URI.

Variants

Name(HostName)

A hostname.

Ip(IpAddr)

A literal IPv4 or IPv6 address.

Implementations

impl Host

pub fn parse_hostport(raw: &Bytes) -> Result<(Self, Option<u16>), UriError>

Parse a host [ ":" port ], as it appears in a URI or in a Via sent-by.

Shared with the Via header so that a hostname is validated the same way wherever it appears; a host that is rejected in a URI must not be accepted in a Via.

pub fn to_bytes(&self) -> Bytes

The host as it should be written, without IPv6 brackets.

pub fn equivalent(&self, other: &Self) -> bool

Whether two hosts are the same.

Hostnames compare case-insensitively. A hostname never matches an IP address, even the one it resolves to — RFC 3261 §19.1.4 is explicit, and a comparison that consulted DNS would be neither pure nor stable.

Trait Implementations

impl Clone for Host

fn clone(&self) -> Host

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Host

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

Formats the value using the given formatter.

impl Display for Host

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

Formats the value using the given formatter.