Struct Question

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

Questions are generic over the domain name type. When read from an actual message, a ParsedName 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: ToName> 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.

impl<Octs> Question<ParsedName<Octs>>

Parsing and Composing

pub fn parse<'a, Src: Octets<Range<'a> = Octs> + ?Sized + 'a>( parser: &mut Parser<'a, Src>, ) -> Result<Self, ParseError>

impl<N: ToName> Question<N>

pub fn compose<Target: Composer + ?Sized>( &self, target: &mut Target, ) -> Result<(), Target::AppendError>

Trait Implementations

impl<N, NN> CanonicalOrd<Question<NN>> for Question<N>

where N: ToName, NN: ToName,

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

Returns the canonical ordering between self and other.

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

Returns whether self is canonically less than other.

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

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

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

Returns whether self is canonically greater than other.

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.

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

Performs copy-assignment from source.

impl<Name: ToName> ComposeQuestion for Question<Name>

fn compose_question<Target: Composer + ?Sized>( &self, target: &mut Target, ) -> Result<(), Target::AppendError>

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: ToName> From<(N, Rtype)> for Question<N>

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

Converts to this type from the input type.

impl<N: ToName> 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: FromStr<Err = FromStrError>> FromStr for Question<N>

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a question from a string.

The string should contain a question as the query name, class, and query type separated by white space. The query name should be first and in the same form as Name::from_str requires. The class and query type follow the name in either order. If the class is left out, it is assumed to be IN.

type Err = FromStrError

The associated error which can be returned from parsing.

impl<N: Hash> 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<Name, SrcName> OctetsFrom<Question<SrcName>> for Question<Name>

where Name: OctetsFrom<SrcName>,

type Error = <Name as OctetsFrom<SrcName>>::Error

fn try_octets_from(source: Question<SrcName>) -> Result<Self, Self::Error>

Performs the conversion.

fn octets_from(source: Source) -> Self

where Self::Error: Into<Infallible>,

Performs an infallible conversion.

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

fn cmp(&self, other: &Self) -> 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, NN> PartialEq<Question<NN>> for Question<N>

where N: ToName, NN: ToName,

fn eq(&self, other: &Question<NN>) -> 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, NN> PartialOrd<Question<NN>> for Question<N>

where N: ToName, NN: ToName,

fn partial_cmp(&self, other: &Question<NN>) -> 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: Copy> Copy for Question<N>

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