rlibphonenumber 2.0.2

A high-performance Rust port of Google's libphonenumber for parsing, formatting, and validating international phone numbers.
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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

use std::{borrow::Cow, fmt::Display, str::FromStr};

use crate::{
    NumberLengthType, PHONE_NUMBER_UTIL, ParseError, PhoneNumber, PhoneNumberFormat,
    PhoneNumberType, ValidationError, enums::Region,
    phonenumberutil::helper_functions::get_national_significant_number_owned,
};

impl PhoneNumber {
    pub fn format_as(&self, format: PhoneNumberFormat) -> Cow<'_, str> {
        PHONE_NUMBER_UTIL.format(self, format)
    }

    pub fn format_in_original_format(&self, region_calling_from: Region) -> Cow<'_, str> {
        PHONE_NUMBER_UTIL.format_in_original_format(self, region_calling_from)
    }

    pub fn format_national_with_carrier_code(&self, carrier_code: impl AsRef<str>) -> String {
        PHONE_NUMBER_UTIL.format_national_number_with_carrier_code(self, carrier_code)
    }

    pub fn format_for_mobile_dialing(
        &self,
        region_calling_from: Region,
        with_formatting: bool,
    ) -> Option<Cow<'_, str>> {
        PHONE_NUMBER_UTIL.format_number_for_mobile_dialing(
            self,
            region_calling_from,
            with_formatting,
        )
    }

    pub fn format_out_of_country_calling_number(
        &self,
        region_calling_from: Region,
    ) -> Cow<'_, str> {
        PHONE_NUMBER_UTIL.format_out_of_country_calling_number(self, region_calling_from)
    }

    pub fn format_out_of_country_keeping_alpha_chars(
        &self,
        region_calling_from: Region,
    ) -> Cow<'_, str> {
        PHONE_NUMBER_UTIL.format_out_of_country_keeping_alpha_chars(self, region_calling_from)
    }

    pub fn get_region_code(&self) -> Option<Region> {
        PHONE_NUMBER_UTIL.get_region_for_number(self)
    }

    pub fn get_type(&self) -> PhoneNumberType {
        PHONE_NUMBER_UTIL.get_number_type(self)
    }

    pub fn can_be_internationally_dialled(&self) -> bool {
        PHONE_NUMBER_UTIL.can_be_internationally_dialled(self)
    }

    pub fn is_geographical(&self) -> bool {
        PHONE_NUMBER_UTIL.is_number_geographical(self)
    }

    pub fn is_valid(&self) -> bool {
        PHONE_NUMBER_UTIL.is_valid_number(self)
    }

    pub fn is_valid_for_region(&self, region: Region) -> bool {
        PHONE_NUMBER_UTIL.is_valid_number_for_region(self, region)
    }

    pub fn is_possible_with_reason(&self) -> Result<NumberLengthType, ValidationError> {
        PHONE_NUMBER_UTIL.is_possible_number_with_reason(self)
    }

    pub fn truncate_too_long_number(&mut self) -> bool {
        PHONE_NUMBER_UTIL.truncate_too_long_number(self)
    }

    pub fn get_length_of_geographical_area_code(&self) -> usize {
        PHONE_NUMBER_UTIL.get_length_of_geographical_area_code(self)
    }

    pub fn get_length_of_national_destination_code(&self) -> usize {
        PHONE_NUMBER_UTIL.get_length_of_national_destination_code(self)
    }

    pub fn get_national_significant_number(&self) -> String {
        get_national_significant_number_owned(self)
    }

    pub fn parse(
        number_to_parse: impl AsRef<str>,
        default_region: Option<Region>,
    ) -> Result<PhoneNumber, ParseError> {
        PHONE_NUMBER_UTIL.parse(number_to_parse, default_region)
    }
}

impl FromStr for PhoneNumber {
    type Err = ParseError;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        Self::parse(s, None)
    }
}

impl Display for PhoneNumber {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{}", self.format_as(PhoneNumberFormat::E164))
    }
}