Struct domain_resolv::lookup::host::FoundHosts

pub struct FoundHosts { /* fields omitted */ }

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.

Methods

impl FoundHosts

pub fn new(canonical: Dname, addrs: Vec<IpAddr>) -> Self

pub fn qname(&self) -> &Dname

Returns a reference to the domain name that was queried.

pub fn canonical_name(&self) -> &Dname

Returns a reference to the canonical name for the host.

Important traits for FoundHostsIter<'a>

impl<'a> Iterator for FoundHostsIter<'a> type Item = IpAddr;

pub fn iter(&self) -> FoundHostsIter

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

Important traits for FoundHostsSocketIter<'a>

impl<'a> Iterator for FoundHostsSocketIter<'a> type Item = SocketAddr;

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 Clone for FoundHosts

fn clone(&self) -> FoundHosts

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for FoundHosts

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

Formats the value using the given formatter.