Struct Query

#[non_exhaustive]
pub struct Query {
    pub name: Name,
    pub query_type: RecordType,
    pub query_class: DNSClass,
}

Query struct for looking up resource records, basically a resource record without RDATA.

RFC 1035, DOMAIN NAMES - IMPLEMENTATION AND SPECIFICATION, November 1987

4.1.2. Question section format

The question section is used to carry the "question" in most queries,
i.e., the parameters that define what is being asked.  The section
contains QDCOUNT (usually 1) entries, each of the following format:

                                    1  1  1  1  1  1
      0  1  2  3  4  5  6  7  8  9  0  1  2  3  4  5
    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
    |                                               |
    /                     QNAME / ZNAME             /
    /                                               /
    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
    |                     QTYPE / ZTYPE             |
    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
    |                     QCLASS / ZCLASS           |
    +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

name: Name

QNAME

query_type: RecordType

QTYPE

query_class: DNSClass

QCLASS

Implementations

impl Query

pub fn new() -> Query

Return a default query with an empty name and A, IN for the query_type and query_class

pub fn query(name: Name, query_type: RecordType) -> Query

Create a new query from name and type, class defaults to IN

pub fn set_name(&mut self, name: Name) -> &mut Query

replaces name with the new name

pub fn set_query_type(&mut self, query_type: RecordType) -> &mut Query

Specify the RecordType being queried

pub fn set_query_class(&mut self, query_class: DNSClass) -> &mut Query

Specify÷ the DNS class of the Query, almost always IN

pub fn name(&self) -> &Name

QNAME           a domain name represented as a sequence of labels, where
                each label consists of a length octet followed by that
                number of octets.  The domain name terminates with the
                zero length octet for the null label of the root.  Note
                that this field may be an odd number of octets; no
                padding is used.

pub fn query_type(&self) -> RecordType

QTYPE           a two octet code which specifies the type of the query.
                The values for this field include all codes valid for a
                TYPE field, together with some more general codes which
                can match more than one type of RR.

pub fn query_class(&self) -> DNSClass

QCLASS          a two octet code that specifies the class of the query.
                For example, the QCLASS field is IN for the Internet.

Trait Implementations

impl<'r> BinDecodable<'r> for Query

fn read(decoder: &mut BinDecoder<'r>) -> Result<Query, ProtoError>

Read the type from the stream

fn from_bytes(bytes: &'r [u8]) -> Result<Self, ProtoError>

Returns the object in binary form

impl BinEncodable for Query

fn emit(&self, encoder: &mut BinEncoder<'_>) -> Result<(), ProtoError>

Write the type to the stream

fn to_bytes(&self) -> Result<Vec<u8>, ProtoError>

Returns the object in binary form

impl Clone for Query

fn clone(&self) -> Query

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Query

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

Formats the value using the given formatter.

impl Default for Query

fn default() -> Query

Return a default query with an empty name and A, IN for the query_type and query_class

impl Display for Query

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

Formats the value using the given formatter.

impl From<Query> for LowerQuery

fn from(query: Query) -> LowerQuery

Converts to this type from the input type.

impl Hash for Query

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

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 Query

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

impl StructuralPartialEq for Query