Struct ParsedRecord

pub struct ParsedRecord<'a, Octs: Octets + ?Sized> { /* 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<'a, Octs: Octets + ?Sized> ParsedRecord<'a, Octs>

pub fn new( header: RecordHeader<ParsedName<&'a Octs>>, data: Parser<'a, Octs>, ) -> 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) -> ParsedName<&'a Octs>

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) -> Ttl

Returns the TTL of the record.

pub fn rdlen(&self) -> u16

Returns the data length of the record.

impl<'a, Octs: Octets + ?Sized> ParsedRecord<'a, Octs>

pub fn to_record<Data>( &self, ) -> Result<Option<Record<ParsedName<Octs::Range<'_>>, Data>>, ParseError>

where Data: ParseRecordData<'a, Octs>,

Creates a real resource record if the record data type supports it.

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 to_any_record<Data>( &self, ) -> Result<Record<ParsedName<Octs::Range<'_>>, Data>, ParseError>

where Data: ParseAnyRecordData<'a, Octs>,

Creates a real resource record.

The method is generic over a type that knows how to parse record data via the ParseAnyRecordData trait. The record data is given to this trait for parsing.

pub fn into_record<Data>( self, ) -> Result<Option<Record<ParsedName<Octs::Range<'a>>, Data>>, ParseError>

where Data: ParseRecordData<'a, Octs>,

Trades for a real resource record if the record data type supports it.

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_any_record<Data>( self, ) -> Result<Record<ParsedName<Octs::Range<'a>>, Data>, ParseError>

where Data: ParseAnyRecordData<'a, Octs>,

Trades for a real resource record.

The method is generic over a type that knows how to parse record data via the ParseAnyRecordData trait. The record data is given to this trait for parsing.

impl<'a, Octs: Octets + ?Sized> ParsedRecord<'a, Octs>

pub fn parse(parser: &mut Parser<'a, Octs>) -> Result<Self, ParseError>

pub fn skip(parser: &mut Parser<'a, Octs>) -> Result<(), ParseError>

Trait Implementations

impl<'a, Octs: Clone + Octets + ?Sized> Clone for ParsedRecord<'a, Octs>

fn clone(&self) -> ParsedRecord<'a, Octs>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, 'o, Octs, Other> PartialEq<ParsedRecord<'o, Other>> for ParsedRecord<'a, Octs>

where Octs: Octets + ?Sized, Other: Octets + ?Sized,

fn eq(&self, other: &ParsedRecord<'o, Other>) -> 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<'a, Octs: Octets + ?Sized> Eq for ParsedRecord<'a, Octs>