Struct codice_fiscale::CodiceFiscale

source ·

pub struct CodiceFiscale { /* private fields */ }

Expand description

Codice fiscale calculation and parsing. The static method check() is most likely what you need.

Note: the PartialEq trait here supposes every PersonData and CodiceFiscaleParts fields are equal, which actually makes for identical persons and not only identical codice fiscale. For comparison you might be better just comparing what is returned by codice() method.

Implementations§

source §

impl CodiceFiscale

source

pub fn check(codice: &str) -> Result<(), Error>

Static method returns true if codice fiscale is valid, false otherwise. Behind the scenes, it calls parse() and returns Ok(()) in case of errors, the Error otherwise. This is the method almost everybody will use.

Examples

use codice_fiscale::*;

if CodiceFiscale::check("BLTMHL77S04E889G").is_ok() {
    println!("Codice is OK!");
}

source

pub fn new(initdata: &PersonData) -> Result<CodiceFiscale, Error>

Constructor which creates a CodiceFiscale struct from personal data, which has to be provided as a PersonData struct

Examples

use codice_fiscale::*;

match CodiceFiscale::new(&PersonData {
    name           : "Michele".to_string(),
    surname        : "Beltrame".to_string(),
    birthdate      : "1977-11-04".to_string(),
    gender         : Gender::M,
    place_of_birth : BELFIORE_STORE.get_info("Rovigo").unwrap().clone(),
}) {
    Ok(cf)  => println!("CF is: {}", cf.get_codice()),
    Err(e)  => println!("Some data was invalid: {:?}", e),    
}

Errors

invalid-birthdate - not a valid YYYY-MM-DD date
invalid-belfiore-code - the place was not found in the database

source

pub fn parse(codice: &str) -> Result<CodiceFiscale, Error>

Constructor which creates a CodiceFiscale struct from a codice fiscale string

Examples

use codice_fiscale::*;

match CodiceFiscale::parse("BLTMHL77S04E889G") {
    Ok(cf)  => println!("CF is OK, birthdate is: {}", cf.get_person_data().birthdate),
    Err(e)  => println!("Codice is invalid beacuse: {:?}", e),    
}

Errors

You will usually get one of the first two errors: if the checkchar matches, it’s very difficult for the codice fiscale to be incorrect, except if it was messed up on purpose.