Struct ParsedRecord

pub struct ParsedRecord { /* private fields */ }

A raw record parsed from a message.

A value of this type contains the record header and the raw record data. It is mainly used as an intermediary type when turning raw message data into Records.

It allows access to the header only but can be traded for a real record of a specific type of ParseRecordData (i.e., some type that knowns how to parse record data) via the to_record and into_record methods.

Implementations

impl ParsedRecord

pub fn new(header: RecordHeader<ParsedDname>, data: Parser) -> Self

Creates a new parsed record from a header and the record data.

The record data is provided via a parser that is positioned at the first byte of the record data.

pub fn owner(&self) -> &ParsedDname

Returns a reference to the owner of the record.

pub fn rtype(&self) -> Rtype

Returns the record type of the record.

pub fn class(&self) -> Class

Returns the class of the record.

pub fn ttl(&self) -> u32

Returns the TTL of the record.

pub fn rdlen(&self) -> u16

Returns the data length of the record.

impl ParsedRecord

pub fn to_record<D>( &self, ) -> Result<Option<Record<ParsedDname, D>>, RecordParseError<ParsedDnameError, D::Err>>

where D: ParseRecordData,

Creates a real resource record from the parsed record.

The method is generic over a type that knows how to parse record data via the ParseRecordData trait. The record data is given to this trait for parsing. If the trait feels capable of parsing this type of record (as indicated by the record type) and parsing succeeds, the method returns Ok(Some(_)). It returns Ok(None) if the trait doesn’t know how to parse this particular record type. It returns an error if parsing fails.

pub fn into_record<D>( self, ) -> Result<Option<Record<ParsedDname, D>>, RecordParseError<ParsedDnameError, D::Err>>

where D: ParseRecordData,

Trades the parsed record for a real resource record.

The method is generic over a type that knows how to parse record data via the ParseRecordData trait. The record data is given to this trait for parsing. If the trait feels capable of parsing this type of record (as indicated by the record type) and parsing succeeds, the method returns Ok(Some(_)). It returns Ok(None) if the trait doesn’t know how to parse this particular record type. It returns an error if parsing fails.

Trait Implementations

impl Clone for ParsedRecord

fn clone(&self) -> ParsedRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParsedRecord

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

Formats the value using the given formatter.

impl Parse for ParsedRecord

type Err = ParsedDnameError

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.