Struct BIC

pub struct BIC {
    pub value: String,
}

SWIFT BIC (Bank Identifier Code) with comprehensive validation and utilities

A Bank Identifier Code (BIC) is used to identify financial institutions in SWIFT messages. It consists of either 8 or 11 characters:

• Bank Code (4 characters): Alphabetic
• Country Code (2 characters): Alphabetic (ISO 3166-1 alpha-2)
• Location Code (2 characters): Alphanumeric
• Branch Code (3 characters, optional): Alphanumeric

Examples

• CHASUS33XXX - Chase Bank, US, New York, Branch: XXX
• DEUTDEFF - Deutsche Bank, Germany, Frankfurt (8-character format)

Fields

value: String

The full BIC code (8 or 11 characters)

Implementations

impl BIC

pub fn new(value: impl Into<String>) -> Result<Self, ParseError>

Create a new BIC with validation

Arguments

• value - The BIC string to validate and store

Returns

• Result<BIC, ParseError> - The validated BIC or an error

Examples

use swift_mt_message::common::BIC;
let bic = BIC::new("CHASUS33XXX".to_string())?;
assert_eq!(bic.bank_code(), "CHAS");

pub fn new_unchecked(value: impl Into<String>) -> Self

Create a BIC without validation (for internal use)

pub fn parse(value: &str, field_tag: Option<&str>) -> Result<Self, ParseError>

Parse a BIC from a string with optional field tag context

pub fn validate(&self) -> ValidationResult

Validate BIC and return ValidationResult for field validation

pub fn value(&self) -> &str

Get the full BIC value

pub fn bank_code(&self) -> &str

Get the bank code (first 4 characters)

pub fn country_code(&self) -> &str

Get the country code (characters 5-6)

pub fn location_code(&self) -> &str

Get the location code (characters 7-8)

pub fn branch_code(&self) -> Option<&str>

Get the branch code if present (characters 9-11)

pub fn is_full_bic(&self) -> bool

Check if this is a full BIC (11 characters) vs short BIC (8 characters)

pub fn is_major_financial_center(&self) -> bool

Check if this institution is in a major financial center

pub fn is_retail_bank(&self) -> bool

Check if this is a retail banking institution (heuristic based on common bank codes)

pub fn supports_real_time_payments(&self) -> bool

Check if this institution’s country supports real-time payments

pub fn regulatory_jurisdiction(&self) -> &'static str

Get the regulatory jurisdiction for this institution

pub fn description(&self) -> String

Get a human-readable description of this BIC

Trait Implementations

impl AsRef<str> for BIC

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for BIC

fn clone(&self) -> BIC

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BIC

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BIC

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for BIC

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

Formats the value using the given formatter.

impl From<BIC> for String

fn from(bic: BIC) -> String

Converts to this type from the input type.

impl FromStr for BIC

type Err = ParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl Hash for BIC

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for BIC

fn eq(&self, other: &BIC) -> 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 Serialize for BIC

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for BIC

impl StructuralPartialEq for BIC