Enum CfiError 

#[non_exhaustive]
pub enum CfiError {
    Empty,
    InvalidLength {
        found: usize,
    },
    InvalidCharacter {
        character: char,
        position: u8,
    },
    UnknownCategory {
        code: char,
    },
    UnknownGroup {
        category: char,
        code: char,
    },
    InvalidAttribute {
        category: char,
        group: char,
        index: u8,
        code: char,
    },
}

The set of reasons a CFI string can fail validation.

Every fallible constructor of Cfi returns this type. Unlike CNPJ or ISIN, a CFI carries no checksum; instead its validity is defined by the ISO 10962 code taxonomy, so beyond the structural checks there are three taxonomic failure modes (CfiError::UnknownCategory, CfiError::UnknownGroup, CfiError::InvalidAttribute). 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 6 characters.

Fields

found: usize

The number of characters found after trimming.

InvalidCharacter

A character outside A–Z was found at a given position. Every CFI position is an uppercase ASCII letter.

Fields

character: char

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

position: u8

1-indexed position within the 6 characters.

UnknownCategory

The category letter (position 1) is not one defined by ISO 10962.

Fields

code: char

The offending category code.

UnknownGroup

The group letter (position 2) is not defined for the otherwise-valid category.

Fields

category: char

The (valid) category code the group was looked up under.

code: char

The offending group code.

InvalidAttribute

An attribute letter (positions 3–6) is not permitted for the resolved category and group at that attribute position.

Fields

category: char

The (valid) category code.

group: char

The (valid) group code.

index: u8

Which attribute failed, 1–4 (corresponding to CFI positions 3–6).

code: char

The offending attribute code.

Trait Implementations

impl Clone for CfiError

fn clone(&self) -> CfiError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CfiError

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

Formats the value using the given formatter.

impl Display for CfiError

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

Formats the value using the given formatter.

impl Eq for CfiError

impl Error for CfiError

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 CfiError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CfiError