Struct PhoneNumber

#[non_exhaustive]
pub struct PhoneNumber {
    pub extension: String,
    pub kind: Option<Kind>,
}

An object representing a phone number, suitable as an API wire format.

This representation:

• should not be used for locale-specific formatting of a phone number, such as “+1 (650) 253-0000 ext. 123”

• is not designed for efficient storage

• may not be suitable for dialing - specialized libraries (see references) should be used to parse the number for that purpose

To do something meaningful with this number, such as format it for various use-cases, convert it to an i18n.phonenumbers.PhoneNumber object first.

For instance, in Java this would be:

com.google.type.PhoneNumber wireProto =

   com.google.type.PhoneNumber.newBuilder().build();

com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber =

   PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ");

if (!wireProto.getExtension().isEmpty()) {

 phoneNumber.setExtension(wireProto.getExtension());

}

Reference(s):

• https://github.com/google/libphonenumber

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

extension: String

The phone number’s extension. The extension is not standardized in ITU recommendations, except for being defined as a series of numbers with a maximum length of 40 digits. Other than digits, some other dialing characters such as ‘,’ (indicating a wait) or ‘#’ may be stored here.

Note that no regions currently use extensions with short codes, so this field is normally only set in conjunction with an E.164 number. It is held separately from the E.164 number to allow for short code extensions in the future.

kind: Option<Kind>

Required. Either a regular number, or a short code. New fields may be added to the oneof below in the future, so clients should ignore phone numbers for which none of the fields they coded against are set.

Implementations

impl PhoneNumber

pub fn set_extension<T: Into<String>>(self, v: T) -> Self

Sets the value of extension.

pub fn set_kind<T: Into<Option<Kind>>>(self, v: T) -> Self

Sets the value of kind.

Trait Implementations

impl Clone for PhoneNumber

fn clone(&self) -> PhoneNumber

Returns a copy 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 Default for PhoneNumber

fn default() -> PhoneNumber

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for PhoneNumber

where PhoneNumber: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for PhoneNumber

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

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PhoneNumber