Struct trust_dns_resolver::lookup_ip::LookupIp

pub struct LookupIp(_);

Result of a DNS query when querying for A or AAAA records.

When resolving IP records, there can be many IPs that match a given name. A consumer of this should expect that there are more than a single address potentially returned. Generally there are multiple IPs stored for a given service in DNS so that there is a form of high availability offered for a given name. The service implementation is resposible for the semantics around which IP should be used and when, but in general if a connection fails to one, the next in the list should be attempted.

Methods

impl LookupIp

Important traits for LookupIpIter<'i>

impl<'i> Iterator for LookupIpIter<'i> type Item = IpAddr;

pub fn iter(&self) -> LookupIpIter

Returns a borrowed iterator of the returned IPs

pub fn query(&self) -> &Query

Returns a reference to the Query that was used to produce this result.

pub fn valid_until(&self) -> Instant

Returns the Instant at which this lookup is no longer valid.

Trait Implementations

impl From<Lookup> for LookupIp

fn from(lookup: Lookup) -> Self

Performs the conversion.

impl Clone for LookupIp

fn clone(&self) -> LookupIp

Returns a copy of the value.

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

Performs copy-assignment from source.

impl IntoIterator for LookupIp

type Item = IpAddr

The type of the elements being iterated over.

type IntoIter = LookupIpIntoIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

This is most likely not a free conversion, the RDatas will be cloned if data is held behind an Arc with more than one reference (which is most likely the case coming from cache)

impl Debug for LookupIp

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

Formats the value using the given formatter.