Struct hickory_resolver::lookup_ip::LookupIp

pub struct LookupIp(/* private fields */);

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 responsible 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.

Implementations

impl LookupIp

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

Returns an iterator over the response records.

Only IP records will be returned, either A or AAAA record types.

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.

pub fn as_lookup(&self) -> &Lookup

Return a reference to the inner lookup

This can be useful for getting all records from the request

Trait Implementations

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 Debug for LookupIp

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

Formats the value using the given formatter.

impl From<Lookup> for LookupIp

fn from(lookup: Lookup) -> Self

Converts to this type from the input type.

impl From<LookupIp> for Lookup

fn from(lookup: LookupIp) -> Self

Converts to this type from the input type.

impl IntoIterator for LookupIp

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)

type Item = IpAddr

The type of the elements being iterated over.

type IntoIter = LookupIpIntoIter

Which kind of iterator are we turning this into?