Struct FoundHosts

pub struct FoundHosts<R: Resolver> { /* private fields */ }

The value returned by a successful host lookup.

You can use the iter() method to get an iterator over the IP addresses or port_iter() to get an iterator over socket addresses with the given port.

The canonical_name() method returns the canonical name of the host for which the addresses were found.

Implementations

impl<R: Resolver> FoundHosts<R>

pub fn new( aaaa: Result<R::Answer, Error>, a: Result<R::Answer, Error>, ) -> Result<Self, Error>

pub fn is_empty(&self) -> bool

impl<R: Resolver> FoundHosts<R>

where R::Octets: Octets,

pub fn qname(&self) -> ParsedName<<R::Octets as Octets>::Range<'_>>

pub fn canonical_name(&self) -> ParsedName<<R::Octets as Octets>::Range<'_>>

Returns a reference to the canonical name for the host.

Notes

This method expects the canonical name to be same in both A/AAAA responses, if it isn’t, it’s going to return a canonical name for one of them.

pub fn iter(&self) -> FoundHostsIter<'_>

Returns an iterator over the IP addresses returned by the lookup.

pub fn port_iter(&self, port: u16) -> FoundHostsSocketIter<'_>

Returns an iterator over socket addresses gained from the lookup.

The socket addresses are gained by combining the IP addresses with port. The returned iterator implements ToSocketAddrs and thus can be used where std::net wants addresses right away.

Trait Implementations

impl<R: Debug + Resolver> Debug for FoundHosts<R>

where R::Answer: Debug,

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

Formats the value using the given formatter.