Struct Question

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

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.

Implementations

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: Clone + ToDname> Clone for Question<N>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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

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

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

Converts to this type from the input type.

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

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

Converts to this type from the input type.

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

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

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

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: PartialEq + ToDname> PartialEq for Question<N>

fn eq(&self, other: &Question<N>) -> 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<N: PartialOrd + ToDname> PartialOrd 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: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

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

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

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

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

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