Enum distant_core::Host

pub enum Host {
    Ipv4(Ipv4Addr),
    Ipv6(Ipv6Addr),
    Name(String),
}

Represents the host of a destination

Variants

Ipv4(Ipv4Addr)

Ipv6(Ipv6Addr)

Name(String)

Represents a hostname that follows the DoD Internet Host Table Specification:

• Hostname can be a maximum of 253 characters including ‘.’
• Each label is a-zA-Z0-9 alongside hyphen (‘-’) and a maximum size of 63 characters
• Labels can be segmented by periods (‘.’)

Implementations

impl Host

pub const fn is_global(&self) -> bool

Indicates whether the host destination is globally routable

pub const fn is_ipv4(&self) -> bool

Returns true if host is an IPv4 address

pub const fn is_ipv6(&self) -> bool

Returns true if host is an IPv6 address

pub const fn is_name(&self) -> bool

Returns true if host is a name

Trait Implementations

impl Clone for Host

fn clone(&self) -> Host

Returns a copy 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<'de> Deserialize<'de> for Host

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where
    D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Display for Host

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

Formats the value using the given formatter.

impl From<IpAddr> for Host

fn from(addr: IpAddr) -> Self

Converts to this type from the input type.

impl From<Ipv4Addr> for Host

fn from(original: Ipv4Addr) -> Host

Converts to this type from the input type.

impl From<Ipv6Addr> for Host

fn from(original: Ipv6Addr) -> Host

Converts to this type from the input type.

impl From<String> for Host

fn from(original: String) -> Host

Converts to this type from the input type.

impl FromStr for Host

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a host from a str

Examples

// IPv4 address
assert_eq!("127.0.0.1".parse(), Ok(Host::Ipv4(Ipv4Addr::new(127, 0, 0, 1))));

// IPv6 address
assert_eq!("::1".parse(), Ok(Host::Ipv6(Ipv6Addr::new(0, 0, 0, 0, 0, 0, 0, 1))));

// Valid hostname
assert_eq!("localhost".parse(), Ok(Host::Name("localhost".to_string())));

// Invalid hostname
assert!("local_host".parse::<Host>().is_err());

type Err = HostParseError

The associated error which can be returned from parsing.

impl Hash for Host

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, 

Feeds a slice of this type into the given Hasher.

impl<'a> PartialEq<&'a str> for Host

fn eq(&self, other: &&'a str) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<Host> for Host

fn eq(&self, other: &Host) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<str> for Host

fn eq(&self, other: &str) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Host

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where
    S: Serializer, 

Serialize this value into the given Serde serializer.

impl Eq for Host

impl StructuralEq for Host

impl StructuralPartialEq for Host