This crate provides an easy way to validate an IBAN (International Bank Account Number). To do
so, you can use the function
parse(). This will check the IBAN rules
as well as the BBAN structure. The provided
Iban structure provides many methods
to easy the handling of an IBAN. Many of these methods are provided via the
When BBAN parsing fails, the error type
ParseIbanError provides useful
information about what went wrong. Additionally, the error contains
which can still be used to access useful information.
The following example does a full validation of the IBAN and BBAN format.
use iban::*; let account = "DE44500105175407324931".parse::<Iban>()?; assert_eq!(account.country_code(), "DE"); assert_eq!(account.check_digits(), 44); assert_eq!(account.bban(), "500105175407324931"); assert_eq!(account.electronic_str(), "DE44500105175407324931"); assert_eq!(account.to_string(), "DE44 5001 0517 5407 3249 31"); assert_eq!(account.bank_identifier(), Some("50010517")); assert_eq!(account.branch_identifier(), None);
Ibantype that can be used to parse account numbers very quickly. It doesn't require allocations at all, and instead leverages
arrayvecunder the hood.
- A flexible API that is useful even when the country is not in the Swift
BaseIban). Instead of using panic, the crate provides typed errors with what went wrong.
- All functionality can be used in a
no_stdenvironment (except for the implementation of
- Optional serialization and deserialization via
- CI tested results via the Swift provided and custom test cases, as well as proptest.
#![forbid(unsafe_code)], making sure all code is written in safe Rust.
The crate can be found on crates.io. To use this crate, just add it as an dependency:
[dependencies] iban_validate = "4"
The following features can be used to configure the crate:
Represents an IBAN that passed basic checks, but not necessarily the BBAN validation. This corresponds to the validation as described in ISO 13616-1.
Represents an IBAN. To obtain it, make use of the
Indicates that the string does not follow the basic IBAN rules.
An error indicating the IBAN could not be parsed.