Struct MessageEncoder 

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

Implementations

impl<'a, S> MessageEncoder<'a, S>

where S: Section,

pub fn set_header(&mut self, header: Header)

Sets the message header.

Note that the MessageEncoder will modify some header fields on drop, to ensure that the message can be parsed correctly.

pub fn finish(self) -> Result<usize, Error>

Finishes encoding the packet, and returns the number of bytes that were written to the buffer.

If the message was truncated because the provided buffer was too small, this will return Error::Truncated, and the message’s truncation bit will be set. In that case, the user can still decide to send the message.

impl<'a> MessageEncoder<'a, Question>

pub fn new(buf: &'a mut [u8]) -> MessageEncoder<'a, Question>

Creates a new message encoder that will write to buf.

Initially, the encoder will be in the Question state, in which questions can be appended to the message by calling MessageEncoder::question. The encoder can either be moved to the next section by calling the appropriate method, or be dropped, which will finish the encoded message.

Panics

buf must be large enough to fit at least the message header (size_of::<Header>()), otherwise this function will panic.

pub fn question(&mut self, question: Question<'_>)

Adds a question to the Question section.

pub fn answers(self) -> MessageEncoder<'a, Answer>

Moves the encoder to the Answer section.

impl<'a> MessageEncoder<'a, Answer>

pub fn add_answer(&mut self, rr: ResourceRecord<'_>)

pub fn authority(self) -> MessageEncoder<'a, Authority>

Moves the encoder to the Authority section.

impl<'a> MessageEncoder<'a, Authority>

pub fn add_authority(&mut self, rr: ResourceRecord<'_>)

pub fn additional(self) -> MessageEncoder<'a, Additional>

Moves the encoder to the Additional Records section.

impl<'a> MessageEncoder<'a, Additional>

pub fn add_additional(&mut self, rr: ResourceRecord<'_>)