Struct domain_core::bits::question::Question

pub struct Question<N: ToDname> { /* fields omitted */ }

A question in a DNS message.

In DNS, a question describes what is requested in a query. It consists of three elements: a domain name, a record type, and a class. This type such a question.

Questions are generic over the domain name type. When read from an actual message, a ParsedDname has to be used because the name part may be compressed.

In order to allow questions on the fly, in particular when creating messages via MessageBuilder, the From trait is implemented for tuples of all three elements of a question as well as for only name and record type assuming Class::In which is likely what you want, anyway.

Methods

impl<N: ToDname> Question<N>

Creation and Conversion

pub fn new(qname: N, qtype: Rtype, qclass: Class) -> Self

Creates a new question from its three componets.

pub fn new_in(qname: N, qtype: Rtype) -> Self

Creates a new question from a name and record type, assuming class IN.

impl<N: ToDname> Question<N>

Field Access

pub fn qname(&self) -> &N

Returns a reference to the domain nmae in the question,

pub fn qtype(&self) -> Rtype

Returns the record type of the question.

pub fn qclass(&self) -> Class

Returns the class of the question.

Trait Implementations

impl<N: ToDname> Compose for Question<N>

fn compose_len(&self) -> usize

Returns the number of bytes this value will need without compression.

fn compose<B: BufMut>(&self, buf: &mut B)

Appends the uncompressed representation of this value to buf.

impl<N: ToDname> Compress for Question<N>

fn compress(&self, buf: &mut Compressor) -> Result<(), ShortBuf>

Appends the wire-format representation of the value to buf.

impl<N: ToDname + Parse> Parse for Question<N>

type Err = <N as Parse>::Err

The type of an error returned when parsing fails.

fn parse(parser: &mut Parser) -> Result<Self, Self::Err>

Extracts a value from the beginning of parser.

fn skip(parser: &mut Parser) -> Result<(), Self::Err>

Skips over a value of this type at the beginning of parser.

impl<N: Eq + ToDname> Eq for Question<N>

impl<N: Clone + ToDname> Clone for Question<N>

fn clone(&self) -> Question<N>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<N: PartialOrd + ToDname> PartialOrd<Question<N>> for Question<N>

fn partial_cmp(&self, other: &Question<N>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Question<N>) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Question<N>) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Question<N>) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Question<N>) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<N: PartialEq + ToDname> PartialEq<Question<N>> for Question<N>

fn eq(&self, other: &Question<N>) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Question<N>) -> bool

This method tests for !=.

impl<N: Ord + ToDname> Ord for Question<N>

fn cmp(&self, other: &Question<N>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

impl<N: ToDname> From<(N, Rtype, Class)> for Question<N>

fn from((name, rtype, class): (N, Rtype, Class)) -> Self

Performs the conversion.

impl<N: ToDname> From<(N, Rtype)> for Question<N>

fn from((name, rtype): (N, Rtype)) -> Self

Performs the conversion.

impl<N: Hash + ToDname> Hash for Question<N>

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

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl<N: Debug + ToDname> Debug for Question<N>

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

Formats the value using the given formatter.

impl<N: ToDname + Display> Display for Question<N>

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

Formats the value using the given formatter.