Struct domain::base::record::ParsedRecord

pub struct ParsedRecord<Ref> { /* 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<Ref> ParsedRecord<Ref>

pub fn new(header: RecordHeader<ParsedDname<Ref>>, data: Parser<Ref>) -> 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<Ref>

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<Ref: OctetsRef> ParsedRecord<Ref>

pub fn to_record<Data>(
    &self
) -> Result<Option<Record<ParsedDname<Ref>, Data>>, ParseError>where
    Data: ParseRecordData<Ref>,

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<Data>(
    self
) -> Result<Option<Record<ParsedDname<Ref>, Data>>, ParseError>where
    Data: ParseRecordData<Ref>,

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<Ref: Clone> Clone for ParsedRecord<Ref>

fn clone(&self) -> ParsedRecord<Ref>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Ref: OctetsRef> Parse<Ref> for ParsedRecord<Ref>

fn parse(parser: &mut Parser<Ref>) -> Result<Self, ParseError>

Extracts a value from the beginning of parser.

fn skip(parser: &mut Parser<Ref>) -> Result<(), ParseError>

Skips over a value of this type at the beginning of parser.

impl<Ref, OtherRef> PartialEq<ParsedRecord<OtherRef>> for ParsedRecord<Ref>where
    Ref: OctetsRef,
    OtherRef: OctetsRef,

fn eq(&self, other: &ParsedRecord<OtherRef>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<Ref: OctetsRef> Eq for ParsedRecord<Ref>