Struct PhoneNumber 

pub struct PhoneNumber {
    pub original: String,
    pub normalized: String,
    pub country: Option<&'static Country>,
    pub phone_type: Option<PhoneNumberType>,
}

A parsed and validated phone number with equality comparison

Two PhoneNumber instances are considered equal if they represent the same phone number, regardless of their original formatting.

Examples

use phonelib::PhoneNumber;
 
let num1 = PhoneNumber::parse("+12025550173").unwrap();
let num2 = PhoneNumber::parse("12025550173").unwrap();
assert_eq!(num1, num2); // Same number, different formats

Fields

original: String

The original input string

normalized: String

The normalized E.164 format

country: Option<&'static Country>

The country information

phone_type: Option<PhoneNumberType>

The phone number type

Implementations

impl PhoneNumber

pub fn parse(input: &str) -> Option<Self>

Parse a string into a PhoneNumber

Arguments

• input - The phone number string to parse

Returns

• Some(PhoneNumber) - If the input is a valid phone number
• None - If the input is invalid

pub fn parse_with_country(input: &str, country_code: &str) -> Option<Self>

Parse a phone number with a country hint for national numbers

Arguments

• input - The phone number string to parse
• country_code - ISO 3166-1 alpha-2 country code

Returns

• Some(PhoneNumber) - If the input is a valid phone number
• None - If the input is invalid

pub fn e164(&self) -> &str

Get the E.164 formatted number

pub fn national_number(&self) -> String

Get the national number (without country code)

pub fn country_code(&self) -> Option<u32>

Get the country code digits

pub fn format(&self, format: PhoneFormat) -> String

Format the phone number

pub fn is_mobile(&self) -> bool

Check if this number is mobile

pub fn is_landline(&self) -> bool

Check if this number is a landline

pub fn is_toll_free(&self) -> bool

Check if this number is toll-free

Trait Implementations

impl Clone for PhoneNumber

fn clone(&self) -> PhoneNumber

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PhoneNumber

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

Formats the value using the given formatter.

impl Display for PhoneNumber

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

Formats the value using the given formatter.

impl FromStr for PhoneNumber

type Err = &'static str

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 PhoneNumber

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 PhoneNumber

fn eq(&self, other: &Self) -> 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 Eq for PhoneNumber