EBookContacts.PhoneNumber
Description: Reference for EBookContacts.PhoneNumber

### Struct

# EBookContactsPhoneNumber

since: 3.8

#### Description [src]

    struct EPhoneNumber {
      /* No available fields */
    }

This opaque type describes a parsed phone number. It can be copied using e_phone_number_copy(). To release it call e_phone_number_free().

Available since: 3.8

#### Functions

###### e_phone_number_compare_strings

Compares two phone numbers.

since: 3.8

###### e_phone_number_compare_strings_with_region

Compares two phone numbers within the context of `region_code`.

since: 3.8

###### e_phone_number_error_quark

No description available.

###### e_phone_number_from_string

Parses the string passed in `phone_number`. Note that no validation is performed whether the recognized phone number is valid for a particular region.

since: 3.8

###### e_phone_number_get_country_code_for_region

Retrieves the preferred country calling code for `region_code`, e.g. 358 for “fi” or 1 for “en_US@UTF-8”.

since: 3.8

###### e_phone_number_get_default_region

Retrieves the current two-letter country code that’s used by default for parsing phone numbers in e_phone_number_from_string(). It can be useful to store this number before parsing a bigger number of phone numbers.

since: 3.8

###### e_phone_number_is_supported

Checks if phone number support is available. It is recommended to call this function before using any of the phone-utils functions to ensure that the required functionality is available, and to pick alternative mechanisms if needed.

since: 3.8

#### Instance methods

###### e_phone_number_compare

Compares two phone numbers.

since: 3.8

###### e_phone_number_copy

Makes a copy of `phone_number`.

since: 3.8

###### e_phone_number_free

Released the memory occupied by `phone_number`.

since: 3.8

###### e_phone_number_get_country_code

Queries the `phone_number`‘s country calling code and optionally stores the country calling code’s origin in `source`. For instance when parsing “+1-617-5423789” this function would return one and assign E_PHONE_NUMBER_COUNTRY_FROM_FQTN to `source`.

since: 3.8

###### e_phone_number_get_national_number

Queries the national portion of `phone_number` without any call-out prefixes. For instance when parsing “+1-617-5423789” this function would return the string “6175423789”.

since: 3.8

###### e_phone_number_to_string

Describes the `phone_number` according to the rules applying to `format`.

since: 3.8