Enum CountryCodeError 

#[non_exhaustive]
pub enum CountryCodeError {
    Empty,
    InvalidLength {
        found: usize,
    },
    InvalidCharacter {
        character: char,
        position: u8,
    },
    Unassigned {
        code: [char; 2],
    },
}

The set of reasons a country code string can fail validation.

Every fallible constructor of CountryCode returns this type. A country code carries no checksum. Its validity is defined by membership in the officially assigned ISO 3166-1 alpha-2 set, so beyond the structural checks there is one assignment failure mode (CountryCodeError::Unassigned). Each variant maps to a single, specific failure, so callers can react programmatically rather than parsing a message.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Empty

The input was an empty string.

InvalidLength

After trimming surrounding whitespace, the input did not contain exactly two characters.

Fields

found: usize

The number of characters found after trimming.

InvalidCharacter

A character outside A to Z was found at a given position. Every position of a country code is an uppercase ASCII letter.

Fields

character: char

The offending character, as originally provided (before case folding).

position: u8

The 1 indexed position within the two characters.

Unassigned

The two letters are well formed but are not a code that ISO 3166-1 officially assigns.

Fields

code: [char; 2]

The offending code, as two uppercase letters.

Trait Implementations

impl Clone for CountryCodeError

fn clone(&self) -> CountryCodeError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CountryCodeError

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

Formats the value using the given formatter.

impl Display for CountryCodeError

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

Formats the value using the given formatter.

impl Eq for CountryCodeError

impl Error for CountryCodeError

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

Returns the lower-level source of this error, if any.

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

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

impl PartialEq for CountryCodeError

fn eq(&self, other: &CountryCodeError) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CountryCodeError