china_identification_card 1.1.2

A Rust library for validating Chinese identification card numbers based on official rules and checksums.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

use crate::*;

/// Implementation of validation methods for Chinese ID card numbers.
impl ChineseIdCard {
    /// Validates whether a given string represents a valid Chinese ID card number.
    ///
    /// # Arguments
    ///
    /// - `T` - A value that can be converted to string representing the ID number.
    ///
    /// # Returns
    ///
    /// - `bool` - Returns true if the ID number is valid, false otherwise.
    pub fn is_valid_id_number<T: ToString>(id_number: T) -> bool {
        let id_number_string: String = id_number.to_string();
        if id_number_string.len() != 18 || !id_number_string[..17].chars().all(|c| c.is_digit(10)) {
            return false;
        }
        let last_char: char = id_number_string.chars().last().unwrap();
        if !(last_char.is_digit(10) || last_char == 'X') {
            return false;
        }
        let sum: i32 = id_number_string[..17]
            .chars()
            .zip(WEIGHTS.iter())
            .map(|(c, &w)| c.to_digit(10).unwrap() as i32 * w)
            .sum();
        let check_code: char = CHECK_CODES[(sum % 11) as usize];
        check_code == last_char
    }

    /// Checks whether a given string represents an invalid Chinese ID card number.
    ///
    /// # Arguments
    ///
    /// - `T` - A value that can be converted to string representing the ID number.
    ///
    /// # Returns
    ///
    /// - `bool` - Returns true if the ID number is invalid, false otherwise.
    pub fn is_invalid_id_number<T: ToString>(id_number: T) -> bool {
        !Self::is_valid_id_number(id_number)
    }
}