Enum fqdn::Error

pub enum Error {
    TrailingDotMissing,
    TrailingNulCharMissing,
    InvalidLabelChar,
    InvalidStructure,
    TooLongDomainName,
    TooLongLabel,
    LabelDoesNotStartWithLetter,
    EmptyLabel,
}

Error when FQDN parsing goes wrong

Variants

TrailingDotMissing

The trailing dot of the FQDN string is missing.

A valid FQDN string should be ended by a dot (e.g. github.com.).

TrailingNulCharMissing

The trailing nul byte of the FQDN bytes is missing.

A valid FQDN array of bytes should be ended by the nul byte (e.g. b"\x06github\x03com\x00")

InvalidLabelChar

An invalid character is found in a label of the FQDN.

The allowed characters in a FQDN label are letters, digits and '-'. By default, this crate also accepts '_' in FQDN but this behavior could be deactivated with the strict-rfc-1035 feature.

InvalidStructure

The analysed bytes are not consistent with a FQDN sequence of bytes.

Typically, the length bytes of labels are not consistent.

TooLongDomainName

The name of the domain is too long

By default, there is no limit except if the strict-rfc-1035 feature is selected and then, the domain name should be less than 255 characters (including the trailing dot).

TooLongLabel

One label of the FQDN is too long

The returned error contains the excessive length.

By default, the limit is set to 255 characters but if the strict-rfc-1035 feature is selected, then this limit is set to 63 (as said in the RFC).

LabelDoesNotStartWithLetter

One label does not start with a letter

The returned error contains the start position of the involved label

EmptyLabel

One label is empty (e.g. starting dot as .github.com. or two following dots as github..com.)

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

fn source(&self) -> Option<&(dyn Error + 'static)>

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace)

Returns a stack backtrace, if available, of where this error occurred.

fn description(&self) -> &str

👎 Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎 Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

impl Hash for Error

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl PartialEq<Error> for Error

fn eq(&self, other: &Error) -> 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 !=.

impl Copy for Error

impl Eq for Error

impl StructuralEq for Error

impl StructuralPartialEq for Error