Enum IpOrHost

pub enum IpOrHost {
    Dns(String, u16),
    Ip(SocketAddr),
}

Implements a host name with port. This could be either a DNS name with port or an IP address with port represented by std::net::SocketAddr.

This object implements std::net::ToSocketAddrs which performs automatic DNS name resolution in case this is a IpOrHost::Dns instance.

Variants

Dns(String, u16)

DNS name and port.

Ip(SocketAddr)

IP address with port.

Implementations

impl IpOrHost

pub async fn resolve_tokio(self) -> Result<Vec<SocketAddr>>

Tries to resolve the DNS name and returns all IP addresses found. If this enum is already an IP address and port, it will simply return it.

Uses tokio resolver.

pub async fn resolve<P: ConnectionProvider>( self, resolver: AsyncResolver<P>, ) -> Result<Vec<SocketAddr>>

Tries to resolve the DNS name and returns all IP addresses found. If this enum is already an IP address and port, it will simply return it.

pub fn port(&self) -> u16

Gets the port number.

pub fn host(&self) -> String

Gets the unresolved DNS name or IP address as string.

pub fn is_dns(&self) -> bool

Checks if this instance is a DNS name.

pub fn is_ipv4(&self) -> bool

Checks if this instance is an IP address and whether it is an IPv4 address.

Always returns false if this instance is a DNS name, i.e.: it does not perform any DNS resolution.

pub fn is_ipv6(&self) -> bool

Checks if this instance is an IP address and whether it is an IPv6 address.

Always returns false if this instance is a DNS name, i.e.: it does not perform any DNS resolution.

pub fn is_loopback_ip(&self) -> bool

Checks if this instance is an IP address and whether it is a loopback address.

Always returns false if this instance is a DNS name, i.e.: it does not perform any DNS resolution.

Trait Implementations

impl Clone for IpOrHost

fn clone(&self) -> IpOrHost

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for IpOrHost

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for IpOrHost

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for IpOrHost

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

Formats the value using the given formatter.

impl From<IpOrHost> for SealedHost

fn from(value: IpOrHost) -> Self

Converts to this type from the input type.

impl From<SocketAddr> for IpOrHost

fn from(value: SocketAddr) -> Self

Converts to this type from the input type.

impl FromStr for IpOrHost

type Err = NetworkTypeError

The associated error which can be returned from parsing.

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

Parses a string s to return a value of this type.

impl Hash for IpOrHost

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 PartialEq for IpOrHost

fn eq(&self, other: &IpOrHost) -> 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 Serialize for IpOrHost

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<SealedHost> for IpOrHost

type Error = NetworkTypeError

The type returned in the event of a conversion error.

fn try_from(value: SealedHost) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for IpOrHost

impl StructuralPartialEq for IpOrHost