Struct MessageDecoder 

pub struct MessageDecoder<'a, S>
where
    S: Section,
{ /* private fields */ }

Streaming decoder for DNS messages.

In DNS messages, sections are ordered as follows:

• Question section
• Answer section
• Authority section
• Additional Records section

To ensure efficient decoding and prevent misuse, the message decoder stores the section it is currently decoding as the S type parameter. Initially (after calling MessageDecoder::new), the decoder is in the section::Question state, and is advanced by calling the appropriate methods.

Implementations

impl<'a> MessageDecoder<'a, Question>

pub fn new(buf: &'a [u8]) -> Result<MessageDecoder<'a, Question>, Error>

Creates a streaming message decoder that will read from buf.

impl<'a, S> MessageDecoder<'a, S>

where S: Section,

pub fn header(&self) -> &Header

Returns the message header.

impl<'a> MessageDecoder<'a, Question>

pub fn next(&mut self) -> Option<Result<Question, Error>>

Reads the next Question from the Question section.

pub fn iter(&mut self) -> QuestionIter<'_, 'a>

Returns an iterator over all Questions in the Question section of the message.

pub fn answers(self) -> Result<MessageDecoder<'a, Answer>, Error>

Skips the remaining entries in the Question section and advances the decoder to the Answer section.

pub fn authority(self) -> Result<MessageDecoder<'a, Authority>, Error>

Skips the remaining entries in the Question section, as well as all entries in the Answer section, and advances the decoder to the Authority section.

pub fn additional(self) -> Result<MessageDecoder<'a, Additional>, Error>

Skips the remaining entries in the Question section, as well as all entries in the Answer and Authority sections, and advances the decoder to the Additional Records section.

impl<'a> MessageDecoder<'a, Answer>

pub fn next(&mut self) -> Option<Result<ResourceRecord<'_>, Error>>

Reads the next ResourceRecord from the Answer section.

pub fn iter(&mut self) -> ResourceRecordIter<'_, 'a, Answer>

Returns an iterator over all resource records in the Answer section.

pub fn authority(self) -> Result<MessageDecoder<'a, Authority>, Error>

Skips the remaining entries in the Answer section, and advances the decoder to the Additional Records section.

pub fn additional(self) -> Result<MessageDecoder<'a, Additional>, Error>

Skips the remaining entries in the Answer section, as well as all entries in the Authority section, and advances the decoder to the Additional Records section.

impl<'a> MessageDecoder<'a, Authority>

pub fn next(&mut self) -> Option<Result<ResourceRecord<'_>, Error>>

Reads the next ResourceRecord from the Authority section.

pub fn iter(&mut self) -> ResourceRecordIter<'_, 'a, Authority>

Returns an iterator over all resource records in the Authority section.

pub fn additional(self) -> Result<MessageDecoder<'a, Additional>, Error>

impl<'a> MessageDecoder<'a, Additional>

pub fn next(&mut self) -> Option<Result<ResourceRecord<'_>, Error>>

Reads the next ResourceRecord from the Additional Records section.

pub fn iter(&mut self) -> ResourceRecordIter<'_, 'a, Additional>

Returns an iterator over all resource records in the Additional Record section.