Struct domain::base::question::Question

pub struct Question<N> { /* 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 represents 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.

Implementations

impl<N> 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.

pub fn into_qname(self) -> N

Converts the question into the qname.

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<Name: ToDname> AsQuestion for Question<Name>

type Name = Name

The domain name used by the qname.

fn qname(&self) -> &Self::Name

Returns a reference to the qname of the question.

fn qtype(&self) -> Rtype

Returns the record type of the question.

fn qclass(&self) -> Class

Returns the class of the question.

fn compose_question<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf> where
    Self::Name: Compose, 

Produces the encoding of the question.

fn compose_question_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf> where
    Self::Name: Compose, 

Produces the canoncial encoding of the question.

impl<N, NN> CanonicalOrd<Question<NN>> for Question<N> where
    N: ToDname,
    NN: ToDname, 

fn canonical_cmp(&self, other: &Question<NN>) -> Ordering

Returns the canonical ordering between self and other.

#[must_use]fn canonical_lt(&self, other: &Rhs) -> bool

Returns whether self is canonically less than other.

#[must_use]fn canonical_le(&self, other: &Rhs) -> bool

Returns whether self is canonically less than or equal to other.

#[must_use]fn canonical_gt(&self, other: &Rhs) -> bool

Returns whether self is canonically greater than other.

#[must_use]fn canonical_ge(&self, other: &Rhs) -> bool

Returns whether self is canonically greater than or equal to other.

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

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

Returns a copy of the value.

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

Performs copy-assignment from source.

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

fn compose<T: OctetsBuilder>(&self, target: &mut T) -> Result<(), ShortBuf>

Appends the concrete representation of the value to the target.

fn compose_canonical<T: OctetsBuilder>(
    &self,
    target: &mut T
) -> Result<(), ShortBuf>

Appends the canonical representation of the value to the target.

impl<N: Copy> Copy for Question<N>

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

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

Formats the value using the given formatter.

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

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

Formats the value using the given formatter.

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

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> Hash for Question<N>

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl<Name, SrcName> OctetsFrom<Question<SrcName>> for Question<Name> where
    Name: OctetsFrom<SrcName>, 

fn octets_from(source: Question<SrcName>) -> Result<Self, ShortBuf>

Performs the conversion.

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

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

#[must_use]pub fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]pub fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]pub fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl<Ref: OctetsRef> Parse<Ref> for Question<ParsedDname<Ref>>

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

Extracts a value from the beginning of parser.

fn skip(parser: &mut Parser<Ref>) -> Result<(), ParseError>

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

impl<N, NN> PartialEq<Question<NN>> for Question<N> where
    N: ToDname,
    NN: ToDname, 

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

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<N, NN> PartialOrd<Question<NN>> for Question<N> where
    N: ToDname,
    NN: ToDname, 

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

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

#[must_use]pub fn lt(&self, other: &Rhs) -> bool

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

#[must_use]pub fn le(&self, other: &Rhs) -> bool

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

#[must_use]pub fn gt(&self, other: &Rhs) -> bool

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

#[must_use]pub fn ge(&self, other: &Rhs) -> bool

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