Enum Host 

pub enum Host<'url> {
    Hostname(Hostname<'url>),
    Ip(IpAddr),
}

Represents the host component of a URL, which can be either a hostname or an IP address.

Variants

Hostname(Hostname<'url>)

A hostname (domain name).

Ip(IpAddr)

An IP address (either IPv4 or IPv6).

Implementations

impl<'host> Host<'host>

pub fn parse(host: &'host str) -> Result<Self, Error>

Parses a string into a Host enum.

This function expects the input string to be a URL host, which can be either an IPv4 address, an IPv6 address, or a hostname.

Arguments

• host - A string slice that holds the host to parse (e.g., "example.com", "127.0.0.1", "::1").

Returns

• Result<Host, Error> - A Host enum if parsing is successful, or an [Error] if parsing fails.

Examples

use faup_rs::Host;

// Parse an IPv4 address
let host = Host::parse("127.0.0.1").unwrap();
assert!(matches!(host, Host::Ip(std::net::IpAddr::V4(_))));

// Parse an IPv6 address
let host = Host::parse("::1").unwrap();
assert!(matches!(host, Host::Ip(std::net::IpAddr::V6(_))));

// Parse a hostname
let host = Host::parse("example.com").unwrap();
assert!(matches!(host, Host::Hostname(_)));

// Parse a hostname with a subdomain
let host = Host::parse("sub.example.com").unwrap();
assert!(matches!(host, Host::Hostname(_)));

// Parse a hostname with a custom TLD
let host = Host::parse("example.b32.i2p").unwrap();
assert!(matches!(host, Host::Hostname(_)));

// Attempt to parse an invalid host
let result = Host::parse("invalid..host");
assert!(matches!(result, Err(faup_rs::Error::InvalidHost)));

pub fn as_hostname(&self) -> Option<&Hostname<'_>>

Returns the hostname component if this is a Host::Hostname variant.

Returns

• Option<&Hostname> - The hostname, or None if this is an IP address.

Trait Implementations

impl<'url> Debug for Host<'url>

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.