Struct ExtendedError 

pub struct ExtendedError<Octs> { /* private fields */ }

Option data for an extended DNS error.

The Extended DNS Error option allows a server to include more detailed information in a response to a failed query why it did. It contains a standardized ExtendedErrorCode for machines and an optional UTF-8 error text for humans.

Implementations

impl<Octs> ExtendedError<Octs>

pub fn new( code: ExtendedErrorCode, text: Option<Str<Octs>>, ) -> Result<ExtendedError<Octs>, LongOptData>

where Octs: AsRef<[u8]>,

Creates a new value from a code and optional text.

Returns an error if text is present but is too long to fit into an option.

pub fn new_with_str( code: ExtendedErrorCode, text: &str, ) -> Result<ExtendedError<Octs>, LongOptData>

where Octs: AsRef<[u8]> + FromBuilder, <Octs as FromBuilder>::Builder: EmptyBuilder, <<Octs as FromBuilder>::Builder as OctetsBuilder>::AppendError: Into<Infallible>,

pub unsafe fn new_unchecked( code: ExtendedErrorCode, text: Option<Result<Str<Octs>, Octs>>, ) -> ExtendedError<Octs>

Creates a new value without checking for the option length.

Safety

The caller must ensure that the length of the wire format of the value does not exceed 65,535 octets.

pub fn code(&self) -> ExtendedErrorCode

Returns the error code.

pub fn text(&self) -> Option<Result<&Str<Octs>, &Octs>>

Returns the text.

If there is no text, returns None. If there is text and it is correctly encoded UTF-8, returns Some(Ok(_)). If there is text but it is not UTF-8, returns Some(Err(_)).

pub fn text_slice(&self) -> Option<&[u8]>

where Octs: AsRef<[u8]>,

Returns the text as an octets slice.

pub fn set_text(&mut self, text: Str<Octs>)

Sets the text field.

pub fn is_private(&self) -> bool

Returns true if the code is in the private range.

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

where Src: Octets<Range<'a> = Octs> + ?Sized, Octs: AsRef<[u8]>,

Trait Implementations

impl<Octs> Clone for ExtendedError<Octs>

where Octs: Clone,

fn clone(&self) -> ExtendedError<Octs>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Octs> ComposeOptData for ExtendedError<Octs>

where Octs: AsRef<[u8]>,

fn compose_len(&self) -> u16

fn compose_option<Target>( &self, target: &mut Target, ) -> Result<(), <Target as OctetsBuilder>::AppendError>

where Target: OctetsBuilder + ?Sized,

impl<Octs> Debug for ExtendedError<Octs>

where Octs: AsRef<[u8]>,

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

Formats the value using the given formatter.

impl<Octs> Display for ExtendedError<Octs>

where Octs: AsRef<[u8]>,

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

Formats the value using the given formatter.

impl<Octs> Eq for ExtendedError<Octs>

where Octs: AsRef<[u8]>,

impl<Octs, Name> From<ExtendedError<Octs>> for AllOptData<Octs, Name>

fn from(value: ExtendedError<Octs>) -> AllOptData<Octs, Name>

Converts to this type from the input type.

impl<Octs> From<ExtendedErrorCode> for ExtendedError<Octs>

fn from(code: ExtendedErrorCode) -> ExtendedError<Octs>

Converts to this type from the input type.

impl<Octs> From<u16> for ExtendedError<Octs>

fn from(code: u16) -> ExtendedError<Octs>

Converts to this type from the input type.

impl<Octs> Hash for ExtendedError<Octs>

where Octs: AsRef<[u8]>,

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<Octs, SrcOcts> OctetsFrom<ExtendedError<SrcOcts>> for ExtendedError<Octs>

where Octs: OctetsFrom<SrcOcts>,

type Error = <Octs as OctetsFrom<SrcOcts>>::Error

fn try_octets_from( source: ExtendedError<SrcOcts>, ) -> Result<ExtendedError<Octs>, <ExtendedError<Octs> as OctetsFrom<ExtendedError<SrcOcts>>>::Error>

Performs the conversion.

fn octets_from(source: Source) -> Self

where Self::Error: Into<Infallible>,

Performs an infallible conversion.

impl<Octs> OptData for ExtendedError<Octs>

fn code(&self) -> OptionCode

Returns the option code associated with this option.

impl<'a, Octs> ParseOptData<'a, Octs> for ExtendedError<<Octs as Octets>::Range<'a>>

where Octs: Octets + ?Sized,

fn parse_option( code: OptionCode, parser: &mut Parser<'a, Octs>, ) -> Result<Option<ExtendedError<<Octs as Octets>::Range<'a>>>, ParseError>

Parses the option code data.

impl<Octs, Other> PartialEq<ExtendedError<Other>> for ExtendedError<Octs>

where Octs: AsRef<[u8]>, Other: AsRef<[u8]>,

fn eq(&self, other: &ExtendedError<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<Octs> TryFrom<(ExtendedErrorCode, Str<Octs>)> for ExtendedError<Octs>

where Octs: AsRef<[u8]>,

type Error = LongOptData

The type returned in the event of a conversion error.

fn try_from( _: (ExtendedErrorCode, Str<Octs>), ) -> Result<ExtendedError<Octs>, <ExtendedError<Octs> as TryFrom<(ExtendedErrorCode, Str<Octs>)>>::Error>

Performs the conversion.