3.0 Native API reference english examination 75/105775/1 accepted/tizen_common accepted/tizen_ivi accepted/tizen_mobile accepted/tizen_wearable accepted/tizen/common/20161220.190904 accepted/tizen/ivi/20161220.223354 accepted/tizen/mobile/20161220.223321 accepted/tizen/unified/20170309.033739 accepted/tizen/wearable/20161220.223334 submit/tizen/20161220.075118 submit/tizen_unified/20170308.100409
authorJeesun Kim <iamjs.kim@samsung.com>
Mon, 19 Dec 2016 11:28:25 +0000 (20:28 +0900)
committerJeesun Kim <iamjs.kim@samsung.com>
Mon, 19 Dec 2016 11:29:27 +0000 (20:29 +0900)
Change-Id: If2273262ceafdb2e30bb840ed1ea31361f8c8e25

doc/phnumber_doc.h
include/phone_number.h
include/phone_number_errors.h
include/phone_number_types.h

index 16b0099c70a24df75df402246c7f63e10ea4b2a6..23f5b7a0ebadd9162e602c89d9c8bd9357e3d528 100644 (file)
  * limitations under the License.
  *
  */
 #ifndef __TIZEN_TELEPHONY_PHONE_NUMBER_UTILS_DOC_H__
 #define __TIZEN_TELEPHONY_PHONE_NUMBER_UTILS_DOC_H__
 
+
 /**
  * @ingroup CAPI_SOCIAL_FRAMEWORK
  * @defgroup CAPI_TELEPHONY_PHONE_NUMBER_UTILS_MODULE Phonenumber utils
- *
- *
  * @section CAPI_TELEPHONY_PHONE_NUMBER_UTILS_MODULE_HEADER Required Header
- *  \#include <phone_number.h>
- *
+ * \#include <phone_number.h>
  *
  * @section CAPI_TELEPHONY_PHONE_NUMBER_UTILS_MODULE_OVERVIEW Overview
  * The phonenumber utils API provides methods for parsing and formatting phone numbers.
  *
  * @section CAPI_TELEPHONY_INFORMATION_SIM_FEATURE Related Features
- * This API is related with the following feature:\n
+ * This API is related with the following feature: \n
  * - http://tizen.org/feature/network.telephony
- *
- * It is recommended to design feature related codes in your application for reliability.\n
- *
- * You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, thereby controlling the procedure of your application.\n
- *
- * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK.\n
- *
+ * It is recommended to design feature related codes in your application for reliability. \n
+ * You can check if a device supports the related features for this API by using @ref CAPI_SYSTEM_SYSTEM_INFO_MODULE, thereby controlling the procedure of your application. \n
+ * To ensure your application is only running on the device with specific features, please define the features in your manifest file using the manifest editor in the SDK. \n
  * More details on featuring your application can be found from <a href="https://developer.tizen.org/development/getting-started/native-application/understanding-tizen-programming/application-filtering"><b>Feature List</b>.</a>
  */
 
 #endif /*  __TIZEN_TELEPHONY_PHONE_NUMBER_UTILS_DOC_H__ */
index c198cdb946cb18a089db9a4dab395e42ae081bbb..12dca05b23d8d8b790e46dd6615803ceacdb656d 100644 (file)
@@ -37,17 +37,14 @@ extern "C"
  * @{
  */
 
 /**
  * @brief Connects to the phonenumber-utils service.
- *
  * @since_tizen 3.0
- *
- * @return     @c 0 on success,
- *             otherwise a negative error value
- *
- * @retval  #PHONE_NUMBER_ERROR_NONE                        Successful
- * @retval  #PHONE_NUMBER_ERROR_SYSTEM               Internal error
- *
+ * @return @c 0 on success,
+ *          otherwise a negative error value
+ * @retval #PHONE_NUMBER_ERROR_NONE Successful
+ * @retval #PHONE_NUMBER_ERROR_SYSTEM Internal error
  * @see phone_number_disconnect()
  */
 int phone_number_connect(void);
@@ -55,116 +52,94 @@ int phone_number_connect(void);
 
 /**
  * @brief Disconnects from the phonenumber-utils service.
- *
  * @since_tizen 3.0
- *
- * @return     @c 0 on success,
- *             otherwise a negative error value
- *
- * @retval  #PHONE_NUMBER_ERROR_NONE                        Successful
- * @retval  #PHONE_NUMBER_ERROR_SYSTEM               Internal error
- *
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval  #PHONE_NUMBER_ERROR_NONE Successful
+ * @retval  #PHONE_NUMBER_ERROR_SYSTEM Internal error
  * @see phone_number_connect()
  */
 int phone_number_disconnect(void);
 
 
 /**
- * @brief Gets the location string from number, region and language.
- *
+ * @brief Gets the location string from number, region, and language.
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- *
  * @remarks You must release @a location using free().
  * @remarks The phonenumber-utils is changed to client/server architecture for performance improvement since 3.0.
- *                phone_number_connect()/phone_number_disconnect() should be called.
- *
- * @param[in]   number    The number
- * @param[in]   region    The region of number
- * @param[in]   language  The language of location
- * @param[out]  location  The location string to be returned
- *
- * @return     @c 0 on success,
- *             otherwise a negative error value
- *
- * @retval  #PHONE_NUMBER_ERROR_NONE                        Successful
- * @retval  #PHONE_NUMBER_ERROR_OUT_OF_MEMORY               Out of memory
- * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER           Invalid parameter
- * @retval  #PHONE_NUMBER_ERROR_FILE_NO_SPACE_ON_DEVICE     FS Full
- * @retval  #PHONE_NUMBER_ERROR_PERMISSION_DENIED           Permission denied
- * @retval  #PHONE_NUMBER_ERROR_NOT_SUPPORTED               Not supported
- * @retval  #PHONE_NUMBER_ERROR_NO_DATA                     Requested data does not exist
- *
- * @pre   phone_number_connect() should be called to open a connection to the phonenumber-utils service. (Since 3.0)
- * @post   phone_number_disconnect() should be called to close a connection to the phonenumber-utils service. (Since 3.0)
- *
+ *          phone_number_connect()/phone_number_disconnect() should be called.
+ * @param[in] number The number
+ * @param[in] region The region of number
+ * @param[in] language The language of location
+ * @param[out] location The location string to be returned
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval  #PHONE_NUMBER_ERROR_NONE Successful
+ * @retval  #PHONE_NUMBER_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval  #PHONE_NUMBER_ERROR_FILE_NO_SPACE_ON_DEVICE FS Full
+ * @retval  #PHONE_NUMBER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval  #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
+ * @retval  #PHONE_NUMBER_ERROR_NO_DATA Requested data does not exist
+ * @pre phone_number_connect() should be called to open a connection to the phonenumber-utils service. (Since 3.0)
+ * @post phone_number_disconnect() should be called to close a connection to the phonenumber-utils service. (Since 3.0)
  */
-int phone_number_get_location_from_number(const char *number,
-               phone_number_region_e region, phone_number_lang_e language, char **location);
+int phone_number_get_location_from_number(const char *number, phone_number_region_e region, phone_number_lang_e language, char **location);
+
 
 /**
  * @brief Gets the formatted number.
- *
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- *
  * @remarks You must release @a formatted_number using free().
  * @remarks The phonenumber-utils is changed to client/server architecture for performance improvement since 3.0.
- *                phone_number_connect()/phone_number_disconnect() should be called.
- *
- * @param[in]   number             The number
- * @param[in]   region             The region of number
- * @param[out]  formatted_number   The formatted number string to be returned
- *
- * @return     @c 0 on success,
- *             otherwise a negative error value
- *
- * @retval  #PHONE_NUMBER_ERROR_NONE                        Successful
- * @retval  #PHONE_NUMBER_ERROR_OUT_OF_MEMORY               Out of memory
- * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER           Invalid parameter
- * @retval  #PHONE_NUMBER_ERROR_FILE_NO_SPACE_ON_DEVICE     FS Full
- * @retval  #PHONE_NUMBER_ERROR_PERMISSION_DENIED           Permission denied
- * @retval  #PHONE_NUMBER_ERROR_NOT_SUPPORTED               Not supported
- * @retval  #PHONE_NUMBER_ERROR_NO_DATA                     Requested data does not exist
- *
- * @pre   phone_number_connect() should be called to open a connection to the phonenumber-utils service. (Since 3.0)
- * @post   phone_number_disconnect() should be called to close a connection to the phonenumber-utils service. (Since 3.0)
+ *          phone_number_connect()/phone_number_disconnect() should be called.
+ * @param[in] number The number
+ * @param[in] region The region of number
+ * @param[out] formatted_number The formatted number string to be returned
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval  #PHONE_NUMBER_ERROR_NONE Successful
+ * @retval  #PHONE_NUMBER_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval  #PHONE_NUMBER_ERROR_FILE_NO_SPACE_ON_DEVICE FS Full
+ * @retval  #PHONE_NUMBER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval  #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
+ * @retval  #PHONE_NUMBER_ERROR_NO_DATA Requested data does not exist
+ * @pre phone_number_connect() should be called to open a connection to the phonenumber-utils service. (Since 3.0)
+ * @post phone_number_disconnect() should be called to close a connection to the phonenumber-utils service. (Since 3.0)
  *
  */
-int phone_number_get_formatted_number(const char *number, phone_number_region_e region,
-               char **formatted_number);
+int phone_number_get_formatted_number(const char *number, phone_number_region_e region, char **formatted_number);
+
 
 /**
  * @brief Gets the normalized number.
  * @details Normalized number starts with plus('+') and country code, and excludes the separators such
- *          as dash or space. It is format of E.164 standard including the country code based on current network.
- *
+ *          as dash or space. It is a format of E.164 standard including the country code based on current network.
  * @since_tizen 3.0
  * @privlevel public
  * @privilege %http://tizen.org/privilege/telephony
- *
  * @remarks You must release @a normalized_number using free().
  * @remarks The phonenumber-utils is changed to client/server architecture for performance improvement since 3.0.
- *                phone_number_connect()/phone_number_disconnect() should be called.
- *
- * @param[in]   number             The number
- * @param[out]  normalized_number  The normalized number string to be returned
- *
- * @return     @c 0 on success,
- *             otherwise a negative error value
- *
- * @retval  #PHONE_NUMBER_ERROR_NONE                        Successful
- * @retval  #PHONE_NUMBER_ERROR_OUT_OF_MEMORY               Out of memory
- * @retval  #PHONE_NUMBER_ERROR_NOT_SUPPORTED               Not supported
- * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER           Invalid parameter
- * @retval  #PHONE_NUMBER_ERROR_PERMISSION_DENIED           Permission denied
- * @retval  #PHONE_NUMBER_ERROR_NO_DATA                     Requested data does not exist
- * @retval  #PHONE_NUMBER_ERROR_SYSTEM                      Internal error
- *
- * @pre   phone_number_connect() should be called to open a connection to the phonenumber-utils service. (Since 3.0)
- * @post   phone_number_disconnect() should be called to close a connection to the phonenumber-utils service. (Since 3.0)
+ *          phone_number_connect()/phone_number_disconnect() should be called.
+ * @param[in] number The number
+ * @param[out] normalized_number The normalized number string to be returned
+ * @return @c 0 on success,
+ *         otherwise a negative error value
+ * @retval  #PHONE_NUMBER_ERROR_NONE Successful
+ * @retval  #PHONE_NUMBER_ERROR_OUT_OF_MEMORY Out of memory
+ * @retval  #PHONE_NUMBER_ERROR_NOT_SUPPORTED Not supported
+ * @retval  #PHONE_NUMBER_ERROR_INVALID_PARAMETER Invalid parameter
+ * @retval  #PHONE_NUMBER_ERROR_PERMISSION_DENIED Permission denied
+ * @retval  #PHONE_NUMBER_ERROR_NO_DATA Requested data does not exist
+ * @retval  #PHONE_NUMBER_ERROR_SYSTEM Internal error
+ * @pre phone_number_connect() should be called to open a connection to the phonenumber-utils service. (Since 3.0)
+ * @post phone_number_disconnect() should be called to close a connection to the phonenumber-utils service. (Since 3.0)
  *
  */
 int phone_number_get_normalized_number(const char *number, char **normalized_number);
 
+
 /**
  * @}
  */
index d77f62eb41582523090a61121cc617c832abfab8..6f4d4a59e014ba565eafb981ae2445273627cc7e 100644 (file)
  * @{
  */
 
 /**
  * @brief Enumeration for phone number errors.
- *
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- *
  */
 typedef enum {
        /* GENERAL */
-       PHONE_NUMBER_ERROR_NONE                        = TIZEN_ERROR_NONE,                      /**< Successful */
-       PHONE_NUMBER_ERROR_IO_ERROR                    = TIZEN_ERROR_IO_ERROR,                  /**< I/O Error */
-       PHONE_NUMBER_ERROR_OUT_OF_MEMORY               = TIZEN_ERROR_OUT_OF_MEMORY,             /**< Out of memory */
-       PHONE_NUMBER_ERROR_INVALID_PARAMETER           = TIZEN_ERROR_INVALID_PARAMETER,         /**< Invalid parameter */
-       PHONE_NUMBER_ERROR_FILE_NO_SPACE_ON_DEVICE     = TIZEN_ERROR_FILE_NO_SPACE_ON_DEVICE,   /**< FS Full */
-       PHONE_NUMBER_ERROR_PERMISSION_DENIED           = TIZEN_ERROR_PERMISSION_DENIED,         /**< Permission denied */
-       PHONE_NUMBER_ERROR_NOT_SUPPORTED               = TIZEN_ERROR_NOT_SUPPORTED,             /**< Not supported */
+       PHONE_NUMBER_ERROR_NONE = TIZEN_ERROR_NONE, /**< Successful */
+       PHONE_NUMBER_ERROR_IO_ERROR = TIZEN_ERROR_IO_ERROR, /**< I/O Error */
+       PHONE_NUMBER_ERROR_OUT_OF_MEMORY = TIZEN_ERROR_OUT_OF_MEMORY, /**< Out of memory */
+       PHONE_NUMBER_ERROR_INVALID_PARAMETER = TIZEN_ERROR_INVALID_PARAMETER, /**< Invalid parameter */
+       PHONE_NUMBER_ERROR_FILE_NO_SPACE_ON_DEVICE = TIZEN_ERROR_FILE_NO_SPACE_ON_DEVICE, /**< FS Full */
+       PHONE_NUMBER_ERROR_PERMISSION_DENIED = TIZEN_ERROR_PERMISSION_DENIED, /**< Permission denied */
+       PHONE_NUMBER_ERROR_NOT_SUPPORTED = TIZEN_ERROR_NOT_SUPPORTED, /**< Not supported */
        /* LOGIC & DATA */
-       PHONE_NUMBER_ERROR_NO_DATA                     = TIZEN_ERROR_NO_DATA,                   /**< Requested data does not exist */
+       PHONE_NUMBER_ERROR_NO_DATA = TIZEN_ERROR_NO_DATA, /**< Requested data does not exist */
        /* ENVIRONMENT & OTHER MODULE */
-       PHONE_NUMBER_ERROR_SYSTEM                      = TIZEN_ERROR_PHONENUMBER_UTILS | 0xEF,  /**< Internal error (Since 3.0) */
+       PHONE_NUMBER_ERROR_SYSTEM = TIZEN_ERROR_PHONENUMBER_UTILS | 0xEF, /**< Internal error (Since 3.0) */
 
 } phone_number_error_e;
 
+
 /**
  * @}
  */
index 3442d54f8ed39a9820552cd7f97874434b827599..5ee8567618f0bfb459079a5fda97e603a1402101 100644 (file)
  * @{
  */
 
 /**
  * @brief Enumeration for language type.
- *
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
- *
  */
 typedef enum {
-       PHONE_NUMBER_LANG_AMHARIC,                      /**< Amharic */
-       PHONE_NUMBER_LANG_ARABIC,                       /**< Arabic */
-       PHONE_NUMBER_LANG_BELARUSIAN,                   /**< Belarusian */
-       PHONE_NUMBER_LANG_BULGARIAN,                    /**< Bulgarian */
-       PHONE_NUMBER_LANG_CHINESE,                      /**< Chinese */
-       PHONE_NUMBER_LANG_CHINESE_TRADITIONAL,          /**< Chinese(Traditional) */
-       PHONE_NUMBER_LANG_CZECH,                        /**< Czech */
-       PHONE_NUMBER_LANG_DUTCH,                        /**< Dutch */
-       PHONE_NUMBER_LANG_ENGLISH,                      /**< English */
-       PHONE_NUMBER_LANG_FINNISH,                      /**< Finnish */
-       PHONE_NUMBER_LANG_FRENCH,                       /**< French */
-       PHONE_NUMBER_LANG_GERMAN,                       /**< German */
-       PHONE_NUMBER_LANG_GREEK,                        /**< Greek */
-       PHONE_NUMBER_LANG_HUNGARIAN,                    /**< Hungarian */
-       PHONE_NUMBER_LANG_INDONESIAN,                   /**< Indonesian */
-       PHONE_NUMBER_LANG_ITALIAN,                      /**< Italian */
-       PHONE_NUMBER_LANG_JAPANESE,                     /**< Japanese */
-       PHONE_NUMBER_LANG_KOREAN,                       /**< Korean */
-       PHONE_NUMBER_LANG_NORTHERN_SAMI,                /**< Northern Sami */
-       PHONE_NUMBER_LANG_PERSIAN,                      /**< Persian */
-       PHONE_NUMBER_LANG_POLISH,                       /**< Polish */
-       PHONE_NUMBER_LANG_PORTUGUESE,                   /**< Portuguese */
-       PHONE_NUMBER_LANG_ROMANIAN,                     /**< Romanian */
-       PHONE_NUMBER_LANG_RUSSIAN,                      /**< Russian */
-       PHONE_NUMBER_LANG_SERBIAN,                      /**< Serbian */
-       PHONE_NUMBER_LANG_SPANISH,                      /**< Spanish */
-       PHONE_NUMBER_LANG_SWEDISH,                      /**< Swedish */
-       PHONE_NUMBER_LANG_THAI,                         /**< Thai */
-       PHONE_NUMBER_LANG_TURKISH,                      /**< Turkish */
-       PHONE_NUMBER_LANG_VIETNAMESE,                   /**< Vietnamese */
-       PHONE_NUMBER_LANG_SYSTEM,                       /**< Current System Value (Since 3.0) */
+       PHONE_NUMBER_LANG_AMHARIC, /**< Amharic */
+       PHONE_NUMBER_LANG_ARABIC, /**< Arabic */
+       PHONE_NUMBER_LANG_BELARUSIAN, /**< Belarusian */
+       PHONE_NUMBER_LANG_BULGARIAN, /**< Bulgarian */
+       PHONE_NUMBER_LANG_CHINESE, /**< Chinese */
+       PHONE_NUMBER_LANG_CHINESE_TRADITIONAL, /**< Chinese(Traditional) */
+       PHONE_NUMBER_LANG_CZECH, /**< Czech */
+       PHONE_NUMBER_LANG_DUTCH, /**< Dutch */
+       PHONE_NUMBER_LANG_ENGLISH, /**< English */
+       PHONE_NUMBER_LANG_FINNISH, /**< Finnish */
+       PHONE_NUMBER_LANG_FRENCH, /**< French */
+       PHONE_NUMBER_LANG_GERMAN, /**< German */
+       PHONE_NUMBER_LANG_GREEK, /**< Greek */
+       PHONE_NUMBER_LANG_HUNGARIAN, /**< Hungarian */
+       PHONE_NUMBER_LANG_INDONESIAN, /**< Indonesian */
+       PHONE_NUMBER_LANG_ITALIAN, /**< Italian */
+       PHONE_NUMBER_LANG_JAPANESE, /**< Japanese */
+       PHONE_NUMBER_LANG_KOREAN, /**< Korean */
+       PHONE_NUMBER_LANG_NORTHERN_SAMI, /**< Northern Sami */
+       PHONE_NUMBER_LANG_PERSIAN, /**< Persian */
+       PHONE_NUMBER_LANG_POLISH, /**< Polish */
+       PHONE_NUMBER_LANG_PORTUGUESE, /**< Portuguese */
+       PHONE_NUMBER_LANG_ROMANIAN, /**< Romanian */
+       PHONE_NUMBER_LANG_RUSSIAN, /**< Russian */
+       PHONE_NUMBER_LANG_SERBIAN, /**< Serbian */
+       PHONE_NUMBER_LANG_SPANISH, /**< Spanish */
+       PHONE_NUMBER_LANG_SWEDISH, /**< Swedish */
+       PHONE_NUMBER_LANG_THAI, /**< Thai */
+       PHONE_NUMBER_LANG_TURKISH, /**< Turkish */
+       PHONE_NUMBER_LANG_VIETNAMESE, /**< Vietnamese */
+       PHONE_NUMBER_LANG_SYSTEM, /**< Current System Value (Since 3.0) */
        PHONE_NUMBER_LANG_MAX,
 } phone_number_lang_e;
 
+
 /**
  * @brief Enumeration for region type.
- *
  * @since_tizen @if MOBILE 2.4 @elseif WEARABLE 3.0 @endif
  *
  */
 typedef enum {
-       PHONE_NUMBER_REGION_ALAND_ISLANDS,                              /**< Aland Islands */
-       PHONE_NUMBER_REGION_ALBANIA,                                    /**< Albania */
-       PHONE_NUMBER_REGION_ALGERIA,                                    /**< Algeria */
-       PHONE_NUMBER_REGION_AMERICAN_SAMOA,                             /**< American Samoa */
-       PHONE_NUMBER_REGION_ANGOLA,                                     /**< Angola */
-       PHONE_NUMBER_REGION_ANGUILLA,                                   /**< Anguilla */
-       PHONE_NUMBER_REGION_ARGENTINA,                                  /**< Argentina */
-       PHONE_NUMBER_REGION_ARMENIA,                                    /**< Armenia */
-       PHONE_NUMBER_REGION_ASCENSION_ISLAND,                           /**< Ascension Island */
-       PHONE_NUMBER_REGION_ATIGUA_AND_BARBUDA,                         /**< Atigua and Barbuda */
-       PHONE_NUMBER_REGION_AUSTRIA,                                    /**< Austria */
-       PHONE_NUMBER_REGION_BAHAMAS,                                    /**< Bahamas */
-       PHONE_NUMBER_REGION_BARBADOS,                                   /**< Barbados */
-       PHONE_NUMBER_REGION_BELARUS,                                    /**< Belarus */
-       PHONE_NUMBER_REGION_BELGIUM,                                    /**< Belgium */
-       PHONE_NUMBER_REGION_BENIN,                                      /**< Benin */
-       PHONE_NUMBER_REGION_BERMUDA,                                    /**< Bermuda */
-       PHONE_NUMBER_REGION_BONAIRE_SINT_EUSTATIUS_AND_SABA,            /**< Bonaire Sint Eustatius and Saba */
-       PHONE_NUMBER_REGION_BOTSWANA,                                   /**< Botswana */
-       PHONE_NUMBER_REGION_BRAZIL,                                     /**< Brazil */
-       PHONE_NUMBER_REGION_BULGARIA,                                   /**< Bulgaria */
-       PHONE_NUMBER_REGION_BURKINA_FASO,                               /**< Burkina Faso */
-       PHONE_NUMBER_REGION_BURUNDI,                                    /**< Burundi */
-       PHONE_NUMBER_REGION_CABO_VERDE,                                 /**< Cabo Verde */
-       PHONE_NUMBER_REGION_CAMEROON,                                   /**< Cameroon */
-       PHONE_NUMBER_REGION_CANADA,                                     /**< Canada */
-       PHONE_NUMBER_REGION_CAYMAN_ISLAND,                              /**< Cayman Island */
-       PHONE_NUMBER_REGION_CHILE,                                      /**< Chile */
-       PHONE_NUMBER_REGION_CHINA,                                      /**< China */
-       PHONE_NUMBER_REGION_COLOMBIA,                                   /**< Colombia */
-       PHONE_NUMBER_REGION_COMOROS,                                    /**< Comoros */
-       PHONE_NUMBER_REGION_CONGO,                                      /**< Congo */
-       PHONE_NUMBER_REGION_COTE_D_IVOIRE,                              /**< Cote d'Ivoire */
-       PHONE_NUMBER_REGION_CUBA,                                       /**< Cuba */
-       PHONE_NUMBER_REGION_CURACAO,                                    /**< Curacao */
-       PHONE_NUMBER_REGION_CZECH_REPUBLIC,                             /**< Czech Republic */
-       PHONE_NUMBER_REGION_DEMOCRATIC_REPUBLIC_OF_THE_CONGO,           /**< Congo (Democratic Republic of the) */
-       PHONE_NUMBER_REGION_DOMINICA,                                   /**< Dominica */
-       PHONE_NUMBER_REGION_DOMINICAN_REPUBLIC,                         /**< Domoinican Republic */
-       PHONE_NUMBER_REGION_EGYPT,                                      /**< Egypt */
-       PHONE_NUMBER_REGION_ESTONIA,                                    /**< Estonia */
-       PHONE_NUMBER_REGION_ETHIOPIA,                                   /**< Ethiopia */
-       PHONE_NUMBER_REGION_FINLAND,                                    /**< Finland */
-       PHONE_NUMBER_REGION_FRANCE,                                     /**< France */
-       PHONE_NUMBER_REGION_GABON,                                      /**< Gabon */
-       PHONE_NUMBER_REGION_GAMBIA,                                     /**< Gambia */
-       PHONE_NUMBER_REGION_GERMANY,                                    /**< Germany */
-       PHONE_NUMBER_REGION_GHANA,                                      /**< Ghana */
-       PHONE_NUMBER_REGION_GREECE,                                     /**< Greece */
-       PHONE_NUMBER_REGION_GREENLAND,                                  /**< Greenland */
-       PHONE_NUMBER_REGION_GRENADA,                                    /**< Grenada */
-       PHONE_NUMBER_REGION_GUAM,                                       /**< Guam */
-       PHONE_NUMBER_REGION_GUERNSEY,                                   /**< Guernsey */
-       PHONE_NUMBER_REGION_GUINEA,                                     /**< Guinea */
-       PHONE_NUMBER_REGION_GUINEA_BISSAU,                              /**< Guinea-Bissau */
-       PHONE_NUMBER_REGION_HUNGARY,                                    /**< Hungary */
-       PHONE_NUMBER_REGION_ICELAND,                                    /**< Iceland */
-       PHONE_NUMBER_REGION_INDIA,                                      /**< India */
-       PHONE_NUMBER_REGION_INDONESIA,                                  /**< Indonesia */
-       PHONE_NUMBER_REGION_IRELAND,                                    /**< Ireland */
-       PHONE_NUMBER_REGION_ISLAMIC_REPUBLIC_OF_IRAN,                   /**< Iran (Islamic Republic of) */
-       PHONE_NUMBER_REGION_ISLE_OF_MAN,                                /**< Isle of Man */
-       PHONE_NUMBER_REGION_ITALY,                                      /**< Italy */
-       PHONE_NUMBER_REGION_JAMAICA,                                    /**< Jamaica */
-       PHONE_NUMBER_REGION_JAPAN,                                      /**< Japan */
-       PHONE_NUMBER_REGION_JERSEY,                                     /**< Jersey */
-       PHONE_NUMBER_REGION_JORDAN,                                     /**< Jordan */
-       PHONE_NUMBER_REGION_KAZAKHSTAN,                                 /**< Kazakhstan */
-       PHONE_NUMBER_REGION_KENYA,                                      /**< Kenya */
-       PHONE_NUMBER_REGION_KIRIBATI,                                   /**< Kiribati */
-       PHONE_NUMBER_REGION_LATVIA,                                     /**< Latvia */
-       PHONE_NUMBER_REGION_LESOTHO,                                    /**< Lesotho */
-       PHONE_NUMBER_REGION_LITHUANIA,                                  /**< Lithuania */
-       PHONE_NUMBER_REGION_LUXEMBOURG,                                 /**< Luxembourg */
-       PHONE_NUMBER_REGION_MADAGASCAR,                                 /**< Madagascar */
-       PHONE_NUMBER_REGION_MAURITANIA,                                 /**< Mauritania */
-       PHONE_NUMBER_REGION_MAURITIUS,                                  /**< Maritius */
-       PHONE_NUMBER_REGION_MONTSERRAT,                                 /**< Montserrat */
-       PHONE_NUMBER_REGION_MOROCCO,                                    /**< Morocco */
-       PHONE_NUMBER_REGION_MOZAMBIQUE,                                 /**< Mazambique */
-       PHONE_NUMBER_REGION_NAMIBIA,                                    /**< Namibia */
-       PHONE_NUMBER_REGION_NETHERLANDS,                                /**< Netherlands */
-       PHONE_NUMBER_REGION_NIGERIA,                                    /**< Nigeria */
-       PHONE_NUMBER_REGION_NORTHERN_MARIANA_ISLANDS,                   /**< Northern Mariana Island */
-       PHONE_NUMBER_REGION_NORWAY,                                     /**< Norway */
-       PHONE_NUMBER_REGION_PERU,                                       /**< Peru */
-       PHONE_NUMBER_REGION_POLAND,                                     /**< Poland */
-       PHONE_NUMBER_REGION_PORTUGAL,                                   /**< Portugal */
-       PHONE_NUMBER_REGION_PUERTO_RICO,                                /**< Puerto Rico */
-       PHONE_NUMBER_REGION_REPUBLIC_OF_KOREA,                          /**< Korea (Republic of) */
-       PHONE_NUMBER_REGION_REPUBLIC_OF_MOLDOVA,                        /**< Moldova (Republic of)  */
-       PHONE_NUMBER_REGION_ROMANIA,                                    /**< Romania */
-       PHONE_NUMBER_REGION_RUSSIAN_FEDERATION,                         /**< Russian Federation */
-       PHONE_NUMBER_REGION_SAINT_HELENA,                               /**< Saint Helena, Ascension and Tristan da Cunha */
-       PHONE_NUMBER_REGION_SAINT_KITTS_AND_NEVIS,                      /**< Saint Kitts and Nevis */
-       PHONE_NUMBER_REGION_SAINT_LUCIA,                                /**< Saint Lucia */
-       PHONE_NUMBER_REGION_SAINT_VINCENT_AND_THE_GRENADINES,           /**< Saint Vincent and the Grenadines */
-       PHONE_NUMBER_REGION_SAO_TOME_AND_PRINCIPE,                      /**< Sao Tome and Principe */
-       PHONE_NUMBER_REGION_SAUDI_ARABIA,                               /**< Saudi Arabia */
-       PHONE_NUMBER_REGION_SENEGAL,                                    /**< Senegal */
-       PHONE_NUMBER_REGION_SERBIA,                                     /**< Serbia */
-       PHONE_NUMBER_REGION_SIERRA_LEONE,                               /**< Sierra Leone */
-       PHONE_NUMBER_REGION_SINT_MAARTEN,                               /**< Sint maarten (Dutch part) */
-       PHONE_NUMBER_REGION_SLOVAKIA,                                   /**< Slovakia */
-       PHONE_NUMBER_REGION_SOMALIA,                                    /**< Somalia */
-       PHONE_NUMBER_REGION_SOUTH_AFRICA,                               /**< South Africa */
-       PHONE_NUMBER_REGION_SPAIN,                                      /**< Spain */
-       PHONE_NUMBER_REGION_SRI_LANKA,                                  /**< Sri Lanka */
-       PHONE_NUMBER_REGION_SUDAN,                                      /**< Sudan */
-       PHONE_NUMBER_REGION_SVALBARD_AND_JAN_MAYEN,                     /**< Svalbard and Jan Mayen */
-       PHONE_NUMBER_REGION_SWAZILAND,                                  /**< Swaziland */
-       PHONE_NUMBER_REGION_SWEDEN,                                     /**< Sweden */
-       PHONE_NUMBER_REGION_SWITZERLAND,                                /**< Switzerland */
-       PHONE_NUMBER_REGION_TAIWAN_PROVINCE_OF_CHINA,                   /**< Taiwan Province of China */
-       PHONE_NUMBER_REGION_THAILAND,                                   /**< Thailand */
-       PHONE_NUMBER_REGION_THE_FORMER_YUGOSLAV_REPUBLIC_OF_MACEDONIA,  /**< Macedonia (the Former Yugoslav Republic of) */
-       PHONE_NUMBER_REGION_TOGO,                                       /**< Togo */
-       PHONE_NUMBER_REGION_TRINIDAD_AND_TOBAGO,                        /**< Trinidad and Tobago */
-       PHONE_NUMBER_REGION_TRISTAN_DA_CUNHA,                           /**< Tristan da Cunha */
-       PHONE_NUMBER_REGION_TUNISIA,                                    /**< Tunisia */
-       PHONE_NUMBER_REGION_TURKEY,                                     /**< Turkey */
-       PHONE_NUMBER_REGION_TURKS_AND_CAICOS_ISLANDS,                   /**< Turks and Caicos Islands */
-       PHONE_NUMBER_REGION_UGANDA,                                     /**< Uganda */
-       PHONE_NUMBER_REGION_UNITED_KINGDOM,                             /**< United Kingdom */
-       PHONE_NUMBER_REGION_UNITED_STATES_OF_AMERICA,                   /**< United States of America */
-       PHONE_NUMBER_REGION_VENEZUELA,                                  /**< Venezuela */
-       PHONE_NUMBER_REGION_VIET_NAM,                                   /**< Viet Nam */
-       PHONE_NUMBER_REGION_VIRGIN_ISLAND_BRITISH,                      /**< Virgin Island (British) */
-       PHONE_NUMBER_REGION_VIRGIN_ISLAND_US,                           /**< Virgin Island (U.S.) */
-       PHONE_NUMBER_REGION_WESTERN_SAHARA,                             /**< Western Sahara */
-       PHONE_NUMBER_REGION_ZAMBIA,                                     /**< Zambia */
-       PHONE_NUMBER_REGION_ZIMBABWE,                                   /**< Zimbabwe */
-       PHONE_NUMBER_REGION_ANDORRA,                                /**< Andorra (Since 3.0) */
-       PHONE_NUMBER_REGION_UNITED_ARAB_EMIRATES,       /**< United Arab Emirates (Since 3.0) */
-       PHONE_NUMBER_REGION_AFGHANISTAN,                         /**< Afghanistan (Since 3.0) */
-       PHONE_NUMBER_REGION_AUSTRALIA,                              /**< Australia (Since 3.0) */
-       PHONE_NUMBER_REGION_ARUBA,                                     /**< Aruba (Since 3.0) */
-       PHONE_NUMBER_REGION_AZERBAIJAN,                            /**< Azerbaijan (Since 3.0) */
-       PHONE_NUMBER_REGION_BOSNIA_AND_HERZEGOVINA,   /**< Bosnia and Herzegovina (Since 3.0) */
-       PHONE_NUMBER_REGION_BANGLADESH,                          /**< Bangladesh (Since 3.0) */
-       PHONE_NUMBER_REGION_BAHRAIN,                                  /**< Bahrain (Since 3.0) */
-       PHONE_NUMBER_REGION_SAINT_BARTHELEMY,               /**< Saint Barthelemy, French Antilles (Since 3.0) */
-       PHONE_NUMBER_REGION_BRUNEI_DARUSSALAM,            /**< Brunei Darussalam (Since 3.0) */
-       PHONE_NUMBER_REGION_BOLIVIA,                                   /**< Bolivia (Since 3.0) */
-       PHONE_NUMBER_REGION_BHUTAN,                                   /**< Bhutan (Since 3.0) */
-       PHONE_NUMBER_REGION_BELIZE,                                     /**< Belize (Since 3.0) */
-       PHONE_NUMBER_REGION_COCOS_ISLANDS,                    /**< Cocos Islands (Since 3.0) */
+       PHONE_NUMBER_REGION_ALAND_ISLANDS, /**< Aland Islands */
+       PHONE_NUMBER_REGION_ALBANIA, /**< Albania */
+       PHONE_NUMBER_REGION_ALGERIA, /**< Algeria */
+       PHONE_NUMBER_REGION_AMERICAN_SAMOA, /**< American Samoa */
+       PHONE_NUMBER_REGION_ANGOLA, /**< Angola */
+       PHONE_NUMBER_REGION_ANGUILLA, /**< Anguilla */
+       PHONE_NUMBER_REGION_ARGENTINA, /**< Argentina */
+       PHONE_NUMBER_REGION_ARMENIA, /**< Armenia */
+       PHONE_NUMBER_REGION_ASCENSION_ISLAND, /**< Ascension Island */
+       PHONE_NUMBER_REGION_ATIGUA_AND_BARBUDA, /**< Atigua and Barbuda */
+       PHONE_NUMBER_REGION_AUSTRIA, /**< Austria */
+       PHONE_NUMBER_REGION_BAHAMAS, /**< Bahamas */
+       PHONE_NUMBER_REGION_BARBADOS, /**< Barbados */
+       PHONE_NUMBER_REGION_BELARUS, /**< Belarus */
+       PHONE_NUMBER_REGION_BELGIUM, /**< Belgium */
+       PHONE_NUMBER_REGION_BENIN, /**< Benin */
+       PHONE_NUMBER_REGION_BERMUDA, /**< Bermuda */
+       PHONE_NUMBER_REGION_BONAIRE_SINT_EUSTATIUS_AND_SABA, /**< Bonaire Sint Eustatius and Saba */
+       PHONE_NUMBER_REGION_BOTSWANA, /**< Botswana */
+       PHONE_NUMBER_REGION_BRAZIL, /**< Brazil */
+       PHONE_NUMBER_REGION_BULGARIA, /**< Bulgaria */
+       PHONE_NUMBER_REGION_BURKINA_FASO, /**< Burkina Faso */
+       PHONE_NUMBER_REGION_BURUNDI, /**< Burundi */
+       PHONE_NUMBER_REGION_CABO_VERDE, /**< Cabo Verde */
+       PHONE_NUMBER_REGION_CAMEROON, /**< Cameroon */
+       PHONE_NUMBER_REGION_CANADA, /**< Canada */
+       PHONE_NUMBER_REGION_CAYMAN_ISLAND, /**< Cayman Island */
+       PHONE_NUMBER_REGION_CHILE, /**< Chile */
+       PHONE_NUMBER_REGION_CHINA, /**< China */
+       PHONE_NUMBER_REGION_COLOMBIA, /**< Colombia */
+       PHONE_NUMBER_REGION_COMOROS, /**< Comoros */
+       PHONE_NUMBER_REGION_CONGO, /**< Congo */
+       PHONE_NUMBER_REGION_COTE_D_IVOIRE, /**< Cote d'Ivoire */
+       PHONE_NUMBER_REGION_CUBA, /**< Cuba */
+       PHONE_NUMBER_REGION_CURACAO, /**< Curacao */
+       PHONE_NUMBER_REGION_CZECH_REPUBLIC, /**< Czech Republic */
+       PHONE_NUMBER_REGION_DEMOCRATIC_REPUBLIC_OF_THE_CONGO, /**< Congo (Democratic Republic of the) */
+       PHONE_NUMBER_REGION_DOMINICA, /**< Dominica */
+       PHONE_NUMBER_REGION_DOMINICAN_REPUBLIC, /**< Domoinican Republic */
+       PHONE_NUMBER_REGION_EGYPT, /**< Egypt */
+       PHONE_NUMBER_REGION_ESTONIA, /**< Estonia */
+       PHONE_NUMBER_REGION_ETHIOPIA, /**< Ethiopia */
+       PHONE_NUMBER_REGION_FINLAND, /**< Finland */
+       PHONE_NUMBER_REGION_FRANCE, /**< France */
+       PHONE_NUMBER_REGION_GABON, /**< Gabon */
+       PHONE_NUMBER_REGION_GAMBIA, /**< Gambia */
+       PHONE_NUMBER_REGION_GERMANY, /**< Germany */
+       PHONE_NUMBER_REGION_GHANA, /**< Ghana */
+       PHONE_NUMBER_REGION_GREECE, /**< Greece */
+       PHONE_NUMBER_REGION_GREENLAND, /**< Greenland */
+       PHONE_NUMBER_REGION_GRENADA, /**< Grenada */
+       PHONE_NUMBER_REGION_GUAM, /**< Guam */
+       PHONE_NUMBER_REGION_GUERNSEY, /**< Guernsey */
+       PHONE_NUMBER_REGION_GUINEA, /**< Guinea */
+       PHONE_NUMBER_REGION_GUINEA_BISSAU, /**< Guinea-Bissau */
+       PHONE_NUMBER_REGION_HUNGARY, /**< Hungary */
+       PHONE_NUMBER_REGION_ICELAND, /**< Iceland */
+       PHONE_NUMBER_REGION_INDIA, /**< India */
+       PHONE_NUMBER_REGION_INDONESIA, /**< Indonesia */
+       PHONE_NUMBER_REGION_IRELAND, /**< Ireland */
+       PHONE_NUMBER_REGION_ISLAMIC_REPUBLIC_OF_IRAN, /**< Iran (Islamic Republic of) */
+       PHONE_NUMBER_REGION_ISLE_OF_MAN, /**< Isle of Man */
+       PHONE_NUMBER_REGION_ITALY, /**< Italy */
+       PHONE_NUMBER_REGION_JAMAICA, /**< Jamaica */
+       PHONE_NUMBER_REGION_JAPAN, /**< Japan */
+       PHONE_NUMBER_REGION_JERSEY, /**< Jersey */
+       PHONE_NUMBER_REGION_JORDAN, /**< Jordan */
+       PHONE_NUMBER_REGION_KAZAKHSTAN, /**< Kazakhstan */
+       PHONE_NUMBER_REGION_KENYA, /**< Kenya */
+       PHONE_NUMBER_REGION_KIRIBATI, /**< Kiribati */
+       PHONE_NUMBER_REGION_LATVIA, /**< Latvia */
+       PHONE_NUMBER_REGION_LESOTHO, /**< Lesotho */
+       PHONE_NUMBER_REGION_LITHUANIA, /**< Lithuania */
+       PHONE_NUMBER_REGION_LUXEMBOURG, /**< Luxembourg */
+       PHONE_NUMBER_REGION_MADAGASCAR, /**< Madagascar */
+       PHONE_NUMBER_REGION_MAURITANIA, /**< Mauritania */
+       PHONE_NUMBER_REGION_MAURITIUS, /**< Maritius */
+       PHONE_NUMBER_REGION_MONTSERRAT, /**< Montserrat */
+       PHONE_NUMBER_REGION_MOROCCO, /**< Morocco */
+       PHONE_NUMBER_REGION_MOZAMBIQUE, /**< Mazambique */
+       PHONE_NUMBER_REGION_NAMIBIA, /**< Namibia */
+       PHONE_NUMBER_REGION_NETHERLANDS, /**< Netherlands */
+       PHONE_NUMBER_REGION_NIGERIA, /**< Nigeria */
+       PHONE_NUMBER_REGION_NORTHERN_MARIANA_ISLANDS, /**< Northern Mariana Island */
+       PHONE_NUMBER_REGION_NORWAY, /**< Norway */
+       PHONE_NUMBER_REGION_PERU, /**< Peru */
+       PHONE_NUMBER_REGION_POLAND, /**< Poland */
+       PHONE_NUMBER_REGION_PORTUGAL, /**< Portugal */
+       PHONE_NUMBER_REGION_PUERTO_RICO, /**< Puerto Rico */
+       PHONE_NUMBER_REGION_REPUBLIC_OF_KOREA,  /**< Korea (Republic of) */
+       PHONE_NUMBER_REGION_REPUBLIC_OF_MOLDOVA, /**< Moldova (Republic of)  */
+       PHONE_NUMBER_REGION_ROMANIA, /**< Romania */
+       PHONE_NUMBER_REGION_RUSSIAN_FEDERATION, /**< Russian Federation */
+       PHONE_NUMBER_REGION_SAINT_HELENA, /**< Saint Helena, Ascension and Tristan da Cunha */
+       PHONE_NUMBER_REGION_SAINT_KITTS_AND_NEVIS, /**< Saint Kitts and Nevis */
+       PHONE_NUMBER_REGION_SAINT_LUCIA, /**< Saint Lucia */
+       PHONE_NUMBER_REGION_SAINT_VINCENT_AND_THE_GRENADINES, /**< Saint Vincent and the Grenadines */
+       PHONE_NUMBER_REGION_SAO_TOME_AND_PRINCIPE, /**< Sao Tome and Principe */
+       PHONE_NUMBER_REGION_SAUDI_ARABIA, /**< Saudi Arabia */
+       PHONE_NUMBER_REGION_SENEGAL, /**< Senegal */
+       PHONE_NUMBER_REGION_SERBIA, /**< Serbia */
+       PHONE_NUMBER_REGION_SIERRA_LEONE, /**< Sierra Leone */
+       PHONE_NUMBER_REGION_SINT_MAARTEN, /**< Sint maarten (Dutch part) */
+       PHONE_NUMBER_REGION_SLOVAKIA, /**< Slovakia */
+       PHONE_NUMBER_REGION_SOMALIA, /**< Somalia */
+       PHONE_NUMBER_REGION_SOUTH_AFRICA, /**< South Africa */
+       PHONE_NUMBER_REGION_SPAIN, /**< Spain */
+       PHONE_NUMBER_REGION_SRI_LANKA, /**< Sri Lanka */
+       PHONE_NUMBER_REGION_SUDAN, /**< Sudan */
+       PHONE_NUMBER_REGION_SVALBARD_AND_JAN_MAYEN, /**< Svalbard and Jan Mayen */
+       PHONE_NUMBER_REGION_SWAZILAND, /**< Swaziland */
+       PHONE_NUMBER_REGION_SWEDEN, /**< Sweden */
+       PHONE_NUMBER_REGION_SWITZERLAND, /**< Switzerland */
+       PHONE_NUMBER_REGION_TAIWAN_PROVINCE_OF_CHINA, /**< Taiwan Province of China */
+       PHONE_NUMBER_REGION_THAILAND, /**< Thailand */
+       PHONE_NUMBER_REGION_THE_FORMER_YUGOSLAV_REPUBLIC_OF_MACEDONIA, /**< Macedonia (the Former Yugoslav Republic of) */
+       PHONE_NUMBER_REGION_TOGO, /**< Togo */
+       PHONE_NUMBER_REGION_TRINIDAD_AND_TOBAGO, /**< Trinidad and Tobago */
+       PHONE_NUMBER_REGION_TRISTAN_DA_CUNHA, /**< Tristan da Cunha */
+       PHONE_NUMBER_REGION_TUNISIA, /**< Tunisia */
+       PHONE_NUMBER_REGION_TURKEY, /**< Turkey */
+       PHONE_NUMBER_REGION_TURKS_AND_CAICOS_ISLANDS, /**< Turks and Caicos Islands */
+       PHONE_NUMBER_REGION_UGANDA, /**< Uganda */
+       PHONE_NUMBER_REGION_UNITED_KINGDOM, /**< United Kingdom */
+       PHONE_NUMBER_REGION_UNITED_STATES_OF_AMERICA, /**< United States of America */
+       PHONE_NUMBER_REGION_VENEZUELA, /**< Venezuela */
+       PHONE_NUMBER_REGION_VIET_NAM, /**< Viet Nam */
+       PHONE_NUMBER_REGION_VIRGIN_ISLAND_BRITISH, /**< Virgin Island (British) */
+       PHONE_NUMBER_REGION_VIRGIN_ISLAND_US, /**< Virgin Island (U.S.) */
+       PHONE_NUMBER_REGION_WESTERN_SAHARA, /**< Western Sahara */
+       PHONE_NUMBER_REGION_ZAMBIA, /**< Zambia */
+       PHONE_NUMBER_REGION_ZIMBABWE, /**< Zimbabwe */
+       PHONE_NUMBER_REGION_ANDORRA, /**< Andorra (Since 3.0) */
+       PHONE_NUMBER_REGION_UNITED_ARAB_EMIRATES, /**< United Arab Emirates (Since 3.0) */
+       PHONE_NUMBER_REGION_AFGHANISTAN, /**< Afghanistan (Since 3.0) */
+       PHONE_NUMBER_REGION_AUSTRALIA, /**< Australia (Since 3.0) */
+       PHONE_NUMBER_REGION_ARUBA, /**< Aruba (Since 3.0) */
+       PHONE_NUMBER_REGION_AZERBAIJAN, /**< Azerbaijan (Since 3.0) */
+       PHONE_NUMBER_REGION_BOSNIA_AND_HERZEGOVINA, /**< Bosnia and Herzegovina (Since 3.0) */
+       PHONE_NUMBER_REGION_BANGLADESH,  /**< Bangladesh (Since 3.0) */
+       PHONE_NUMBER_REGION_BAHRAIN, /**< Bahrain (Since 3.0) */
+       PHONE_NUMBER_REGION_SAINT_BARTHELEMY, /**< Saint Barthelemy, French Antilles (Since 3.0) */
+       PHONE_NUMBER_REGION_BRUNEI_DARUSSALAM, /**< Brunei Darussalam (Since 3.0) */
+       PHONE_NUMBER_REGION_BOLIVIA, /**< Bolivia (Since 3.0) */
+       PHONE_NUMBER_REGION_BHUTAN, /**< Bhutan (Since 3.0) */
+       PHONE_NUMBER_REGION_BELIZE, /**< Belize (Since 3.0) */
+       PHONE_NUMBER_REGION_COCOS_ISLANDS, /**< Cocos Islands (Since 3.0) */
        PHONE_NUMBER_REGION_CENTRAL_AFRICAN_REPUBLIC, /**< Central African Republic (Since 3.0) */
-       PHONE_NUMBER_REGION_COOK_ISLANDS,                       /**< Cook Islands (Since 3.0) */
-       PHONE_NUMBER_REGION_COSTA_RICA,                            /**< Costa Rica (Since 3.0) */
-       PHONE_NUMBER_REGION_CHRISTMAS_ISLANDS,             /**< Christmas Islands (Since 3.0) */
-       PHONE_NUMBER_REGION_CYPRUS,                                   /**< Cyprus (Since 3.0) */
-       PHONE_NUMBER_REGION_DJIBOUTI,                                 /**< Djibouti (Since 3.0) */
-       PHONE_NUMBER_REGION_DENMARK,                                 /**< Denmark (Since 3.0) */
-       PHONE_NUMBER_REGION_ECUADOR,                                 /**< Ecuador (Since 3.0) */
-       PHONE_NUMBER_REGION_ERITREA,                                   /**< Eritrea (Since 3.0) */
-       PHONE_NUMBER_REGION_FIJI,                                           /**< Fiji (Since 3.0) */
-       PHONE_NUMBER_REGION_FALKLAND_ISLANDS,                /**< Falkland Islands (Since 3.0) */
-       PHONE_NUMBER_REGION_MICRONESIA,                             /**< Micronesia, Federated States of (Since 3.0) */
-       PHONE_NUMBER_REGION_FAROE_ISLANDS,                       /**< Faroe Islands (Since 3.0) */
-       PHONE_NUMBER_REGION_GEORGIA,                                  /**< Georgia (Since 3.0) */
-       PHONE_NUMBER_REGION_FRENCH_GUIANA,                      /**< French Guiana (Since 3.0) */
-       PHONE_NUMBER_REGION_GIBRALTAR,                               /**< Gibraltar (Since 3.0) */
-       PHONE_NUMBER_REGION_GUADELOUPE,                           /**< Guadeloupe (Since 3.0) */
-       PHONE_NUMBER_REGION_EQUATORIAL_GUINEA,              /**< Equatorial Guinea (Since 3.0) */
-       PHONE_NUMBER_REGION_GUATEMALA,                            /**< Guatemala (Since 3.0) */
-       PHONE_NUMBER_REGION_GUYANA,                                   /**< Guyana (Since 3.0) */
-       PHONE_NUMBER_REGION_HONG_KONG,                           /**< Hong Kong (Since 3.0) */
-       PHONE_NUMBER_REGION_HONDURAS,                              /**< Honduras (Since 3.0) */
-       PHONE_NUMBER_REGION_CROATIA,                                 /**< Croatia (Since 3.0) */
-       PHONE_NUMBER_REGION_HAITI,                                       /**< Haiti (Since 3.0) */
-       PHONE_NUMBER_REGION_ISRAEL,                                    /**< Israel (Since 3.0) */
-       PHONE_NUMBER_REGION_DIEGO_GARCIA,                        /**< British Indian Ocean Territory / Diego Garcia (Since 3.0) */
-       PHONE_NUMBER_REGION_IRAQ,                                        /**< Iraq (Since 3.0) */
-       PHONE_NUMBER_REGION_KYRGYZSTAN,                           /**< Kyrgyzstan (Since 3.0) */
-       PHONE_NUMBER_REGION_CAMBODIA,                               /**< Cambodia (Since 3.0) */
-       PHONE_NUMBER_REGION_NORTH_KOREA,                         /**< Korea, Dem. People's Rep. of (Since 3.0) */
-       PHONE_NUMBER_REGION_KUWAIT,                                    /**< Kuwait (Since 3.0) */
-       PHONE_NUMBER_REGION_LAOS,                                        /**< Lao People's Dem. Rep. (Since 3.0) */
-       PHONE_NUMBER_REGION_LEBANON,                                  /**< Lebanon (Since 3.0) */
-       PHONE_NUMBER_REGION_LIECHTENSTEIN,                         /**< Liechtenstein (Since 3.0) */
-       PHONE_NUMBER_REGION_LIBERIA,                                    /**< Liberia (Since 3.0) */
-       PHONE_NUMBER_REGION_LIBYA,                                        /**< Libya (Soc. People's Libyan Arab Jamahiriya) (Since 3.0) */
-       PHONE_NUMBER_REGION_MONACO,                                   /**< Monaco (Since 3.0) */
-       PHONE_NUMBER_REGION_MONTENEGRO,                          /**< Montenegro (Since 3.0) */
-       PHONE_NUMBER_REGION_SAINT_MARTIN,                          /**< Saint-Martin, French Antilles (Since 3.0) */
-       PHONE_NUMBER_REGION_MARSHALL_ISLANDS,                /**< Marshall Islands (Since 3.0) */
-       PHONE_NUMBER_REGION_MALI,                                          /**< Mali (Since 3.0) */
-       PHONE_NUMBER_REGION_MYANMAR,                                  /**< Myanmar (Since 3.0) */
-       PHONE_NUMBER_REGION_MONGOLIA,                                /**< Mongolia (Since 3.0) */
-       PHONE_NUMBER_REGION_MACAO,                                     /**< Macao, China (Since 3.0) */
-       PHONE_NUMBER_REGION_MARTINIQUE,                             /**< Martinique (French Dept. of) (Since 3.0) */
-       PHONE_NUMBER_REGION_MALTA,                                      /**< Malta (Since 3.0) */
-       PHONE_NUMBER_REGION_MALDIVES,                                /**< Maldives (Since 3.0) */
-       PHONE_NUMBER_REGION_MALAWI,                                   /**< Malawi (Since 3.0) */
-       PHONE_NUMBER_REGION_MEXICO,                                   /**< Mexico (Since 3.0) */
-       PHONE_NUMBER_REGION_MALAYSIA,                               /**< Malaysia (Since 3.0) */
-       PHONE_NUMBER_REGION_NEW_CALEDONIA,                    /**< New Caledonia (Territoire francais d'outre-mer) (Since 3.0) */
-       PHONE_NUMBER_REGION_NIGER,                                      /**< Niger (Since 3.0) */
-       PHONE_NUMBER_REGION_NORFOLK_ISLAND,                    /**< Norfolk Island (Since 3.0) */
-       PHONE_NUMBER_REGION_NICARAGUA,                              /**< Nicaragua (Since 3.0) */
-       PHONE_NUMBER_REGION_NEPAL,                                       /**< Nepal (Since 3.0) */
-       PHONE_NUMBER_REGION_NAURU,                                     /**< Nauru (Since 3.0) */
-       PHONE_NUMBER_REGION_NIUE,                                         /**< Niue (Since 3.0) */
-       PHONE_NUMBER_REGION_NEW_ZEALAND,                        /**< New Zealand (Since 3.0) */
-       PHONE_NUMBER_REGION_OMAN,                                     /**< Oman (Since 3.0) */
-       PHONE_NUMBER_REGION_PANAMA,                                 /**< Panama (Since 3.0) */
-       PHONE_NUMBER_REGION_FRENCH_POLYNESIA,              /**< French Polynesia (Tahiti) (Territoire francais d'outre-mer) (Since 3.0) */
-       PHONE_NUMBER_REGION_PAPUA_NEW_GUINEA,             /**< Papua New Guinea (Since 3.0) */
-       PHONE_NUMBER_REGION_PHILIPPINES,                           /**< Philippines (Since 3.0) */
-       PHONE_NUMBER_REGION_PAKISTAN,                              /**< Pakistan (Since 3.0) */
+       PHONE_NUMBER_REGION_COOK_ISLANDS, /**< Cook Islands (Since 3.0) */
+       PHONE_NUMBER_REGION_COSTA_RICA, /**< Costa Rica (Since 3.0) */
+       PHONE_NUMBER_REGION_CHRISTMAS_ISLANDS, /**< Christmas Islands (Since 3.0) */
+       PHONE_NUMBER_REGION_CYPRUS, /**< Cyprus (Since 3.0) */
+       PHONE_NUMBER_REGION_DJIBOUTI, /**< Djibouti (Since 3.0) */
+       PHONE_NUMBER_REGION_DENMARK, /**< Denmark (Since 3.0) */
+       PHONE_NUMBER_REGION_ECUADOR, /**< Ecuador (Since 3.0) */
+       PHONE_NUMBER_REGION_ERITREA, /**< Eritrea (Since 3.0) */
+       PHONE_NUMBER_REGION_FIJI, /**< Fiji (Since 3.0) */
+       PHONE_NUMBER_REGION_FALKLAND_ISLANDS, /**< Falkland Islands (Since 3.0) */
+       PHONE_NUMBER_REGION_MICRONESIA, /**< Micronesia, Federated States of (Since 3.0) */
+       PHONE_NUMBER_REGION_FAROE_ISLANDS, /**< Faroe Islands (Since 3.0) */
+       PHONE_NUMBER_REGION_GEORGIA, /**< Georgia (Since 3.0) */
+       PHONE_NUMBER_REGION_FRENCH_GUIANA, /**< French Guiana (Since 3.0) */
+       PHONE_NUMBER_REGION_GIBRALTAR, /**< Gibraltar (Since 3.0) */
+       PHONE_NUMBER_REGION_GUADELOUPE, /**< Guadeloupe (Since 3.0) */
+       PHONE_NUMBER_REGION_EQUATORIAL_GUINEA, /**< Equatorial Guinea (Since 3.0) */
+       PHONE_NUMBER_REGION_GUATEMALA, /**< Guatemala (Since 3.0) */
+       PHONE_NUMBER_REGION_GUYANA, /**< Guyana (Since 3.0) */
+       PHONE_NUMBER_REGION_HONG_KONG, /**< Hong Kong (Since 3.0) */
+       PHONE_NUMBER_REGION_HONDURAS, /**< Honduras (Since 3.0) */
+       PHONE_NUMBER_REGION_CROATIA, /**< Croatia (Since 3.0) */
+       PHONE_NUMBER_REGION_HAITI, /**< Haiti (Since 3.0) */
+       PHONE_NUMBER_REGION_ISRAEL, /**< Israel (Since 3.0) */
+       PHONE_NUMBER_REGION_DIEGO_GARCIA, /**< British Indian Ocean Territory / Diego Garcia (Since 3.0) */
+       PHONE_NUMBER_REGION_IRAQ, /**< Iraq (Since 3.0) */
+       PHONE_NUMBER_REGION_KYRGYZSTAN, /**< Kyrgyzstan (Since 3.0) */
+       PHONE_NUMBER_REGION_CAMBODIA, /**< Cambodia (Since 3.0) */
+       PHONE_NUMBER_REGION_NORTH_KOREA, /**< Korea, Dem. People's Rep. of (Since 3.0) */
+       PHONE_NUMBER_REGION_KUWAIT, /**< Kuwait (Since 3.0) */
+       PHONE_NUMBER_REGION_LAOS, /**< Lao People's Dem. Rep. (Since 3.0) */
+       PHONE_NUMBER_REGION_LEBANON, /**< Lebanon (Since 3.0) */
+       PHONE_NUMBER_REGION_LIECHTENSTEIN, /**< Liechtenstein (Since 3.0) */
+       PHONE_NUMBER_REGION_LIBERIA, /**< Liberia (Since 3.0) */
+       PHONE_NUMBER_REGION_LIBYA, /**< Libya (Soc. People's Libyan Arab Jamahiriya) (Since 3.0) */
+       PHONE_NUMBER_REGION_MONACO, /**< Monaco (Since 3.0) */
+       PHONE_NUMBER_REGION_MONTENEGRO,  /**< Montenegro (Since 3.0) */
+       PHONE_NUMBER_REGION_SAINT_MARTIN,  /**< Saint-Martin, French Antilles (Since 3.0) */
+       PHONE_NUMBER_REGION_MARSHALL_ISLANDS, /**< Marshall Islands (Since 3.0) */
+       PHONE_NUMBER_REGION_MALI, /**< Mali (Since 3.0) */
+       PHONE_NUMBER_REGION_MYANMAR, /**< Myanmar (Since 3.0) */
+       PHONE_NUMBER_REGION_MONGOLIA, /**< Mongolia (Since 3.0) */
+       PHONE_NUMBER_REGION_MACAO, /**< Macao, China (Since 3.0) */
+       PHONE_NUMBER_REGION_MARTINIQUE, /**< Martinique (French Dept. of) (Since 3.0) */
+       PHONE_NUMBER_REGION_MALTA, /**< Malta (Since 3.0) */
+       PHONE_NUMBER_REGION_MALDIVES, /**< Maldives (Since 3.0) */
+       PHONE_NUMBER_REGION_MALAWI, /**< Malawi (Since 3.0) */
+       PHONE_NUMBER_REGION_MEXICO, /**< Mexico (Since 3.0) */
+       PHONE_NUMBER_REGION_MALAYSIA, /**< Malaysia (Since 3.0) */
+       PHONE_NUMBER_REGION_NEW_CALEDONIA, /**< New Caledonia (Territoire francais d'outre-mer) (Since 3.0) */
+       PHONE_NUMBER_REGION_NIGER, /**< Niger (Since 3.0) */
+       PHONE_NUMBER_REGION_NORFOLK_ISLAND, /**< Norfolk Island (Since 3.0) */
+       PHONE_NUMBER_REGION_NICARAGUA, /**< Nicaragua (Since 3.0) */
+       PHONE_NUMBER_REGION_NEPAL, /**< Nepal (Since 3.0) */
+       PHONE_NUMBER_REGION_NAURU, /**< Nauru (Since 3.0) */
+       PHONE_NUMBER_REGION_NIUE, /**< Niue (Since 3.0) */
+       PHONE_NUMBER_REGION_NEW_ZEALAND, /**< New Zealand (Since 3.0) */
+       PHONE_NUMBER_REGION_OMAN, /**< Oman (Since 3.0) */
+       PHONE_NUMBER_REGION_PANAMA, /**< Panama (Since 3.0) */
+       PHONE_NUMBER_REGION_FRENCH_POLYNESIA, /**< French Polynesia (Tahiti) (Territoire francais d'outre-mer) (Since 3.0) */
+       PHONE_NUMBER_REGION_PAPUA_NEW_GUINEA, /**< Papua New Guinea (Since 3.0) */
+       PHONE_NUMBER_REGION_PHILIPPINES, /**< Philippines (Since 3.0) */
+       PHONE_NUMBER_REGION_PAKISTAN, /**< Pakistan (Since 3.0) */
        PHONE_NUMBER_REGION_SAINT_PIERRE_AND_MIQUELON, /**< Saint Pierre and Miquelon (Collectivite territoriale de la Republique francaise) (Since 3.0) */
-       PHONE_NUMBER_REGION_PALESTINIAN_AUTHORITY,     /**< Palestinian Authority (Since 3.0) */
-       PHONE_NUMBER_REGION_PALAU,                                     /**< Palau (Since 3.0) */
-       PHONE_NUMBER_REGION_PARAGUAY,                              /**< Paraguay (Since 3.0) */
-       PHONE_NUMBER_REGION_QATAR,                                     /**< Qatar (Since 3.0) */
-       PHONE_NUMBER_REGION_REUNION,                                  /**< Reunion (French Departments and Territories in the Indian Ocean) (Since 3.0) */
-       PHONE_NUMBER_REGION_RWANDA,                                 /**< Rwanda (Since 3.0) */
-       PHONE_NUMBER_REGION_SOLOMON_ISLANDS,               /**< Solomon Islands (Since 3.0) */
-       PHONE_NUMBER_REGION_SEYCHELLES,                          /**< Seychelles (Since 3.0) */
-       PHONE_NUMBER_REGION_SINGAPORE,                             /**< Singapore (Since 3.0) */
-       PHONE_NUMBER_REGION_SLOVENIA,                               /**< Slovenia (Since 3.0) */
-       PHONE_NUMBER_REGION_SAN_MARINO,                          /**< San Marino (Since 3.0) */
-       PHONE_NUMBER_REGION_SURINAME,                               /**< Suriname (Since 3.0) */
-       PHONE_NUMBER_REGION_SOUTH_SUDAN,                        /**< South Sudan (Since 3.0) */
-       PHONE_NUMBER_REGION_EL_SALVADOR,                         /**< El Salvador (Since 3.0) */
-       PHONE_NUMBER_REGION_SYRIAN_ARAB_REPUBLIC,        /**< Syrian Arab Republic (Since 3.0) */
-       PHONE_NUMBER_REGION_CHAD,                                       /**< Chad (Since 3.0) */
-       PHONE_NUMBER_REGION_TAJIKISTAN,                              /**< Tajikistan (Since 3.0) */
-       PHONE_NUMBER_REGION_TOKELAU,                                 /**< Tokelau (Since 3.0) */
-       PHONE_NUMBER_REGION_TIMOR_LESTE,                          /**< Timor-Leste (East Timor) (Since 3.0) */
-       PHONE_NUMBER_REGION_TURKMENISTAN,                      /**< Turkmenistan (Since 3.0) */
-       PHONE_NUMBER_REGION_TONGA,                                    /**< Tonga (Since 3.0) */
-       PHONE_NUMBER_REGION_TUVALU,                                   /**< Tuvalu (Since 3.0) */
-       PHONE_NUMBER_REGION_TANZANIA,                                /**< Tanzania (Since 3.0) */
-       PHONE_NUMBER_REGION_UKRAINE,                                  /**< Ukraine (Since 3.0) */
-       PHONE_NUMBER_REGION_URUGUAY,                                 /**< Uruguay (Since 3.0) */
-       PHONE_NUMBER_REGION_UZBEKISTAN,                            /**< Uzbekistan (Since 3.0) */
-       PHONE_NUMBER_REGION_VATICAN_CITY,                          /**< Vatican City (Since 3.0) */
-       PHONE_NUMBER_REGION_VANUATU,                                /**< Vanuatu (Since 3.0) */
-       PHONE_NUMBER_REGION_WALLIS_AND_FUTUNA,            /**< Wallis and Futuna (Territoire francais d'outre-mer) (Since 3.0) */
-       PHONE_NUMBER_REGION_SAMOA,                                    /**< Samoa (Since 3.0) */
-       PHONE_NUMBER_REGION_YEMEN,                                     /**< Yemen (Since 3.0) */
-       PHONE_NUMBER_REGION_MAYOTTE,                                /**< Mayotte (Since 3.0) */
-       PHONE_NUMBER_REGION_SYSTEM,                                     /**< Current System Value (Since 3.0) */
+       PHONE_NUMBER_REGION_PALESTINIAN_AUTHORITY, /**< Palestinian Authority (Since 3.0) */
+       PHONE_NUMBER_REGION_PALAU, /**< Palau (Since 3.0) */
+       PHONE_NUMBER_REGION_PARAGUAY, /**< Paraguay (Since 3.0) */
+       PHONE_NUMBER_REGION_QATAR, /**< Qatar (Since 3.0) */
+       PHONE_NUMBER_REGION_REUNION, /**< Reunion (French Departments and Territories in the Indian Ocean) (Since 3.0) */
+       PHONE_NUMBER_REGION_RWANDA, /**< Rwanda (Since 3.0) */
+       PHONE_NUMBER_REGION_SOLOMON_ISLANDS, /**< Solomon Islands (Since 3.0) */
+       PHONE_NUMBER_REGION_SEYCHELLES,  /**< Seychelles (Since 3.0) */
+       PHONE_NUMBER_REGION_SINGAPORE, /**< Singapore (Since 3.0) */
+       PHONE_NUMBER_REGION_SLOVENIA, /**< Slovenia (Since 3.0) */
+       PHONE_NUMBER_REGION_SAN_MARINO,  /**< San Marino (Since 3.0) */
+       PHONE_NUMBER_REGION_SURINAME, /**< Suriname (Since 3.0) */
+       PHONE_NUMBER_REGION_SOUTH_SUDAN, /**< South Sudan (Since 3.0) */
+       PHONE_NUMBER_REGION_EL_SALVADOR, /**< El Salvador (Since 3.0) */
+       PHONE_NUMBER_REGION_SYRIAN_ARAB_REPUBLIC, /**< Syrian Arab Republic (Since 3.0) */
+       PHONE_NUMBER_REGION_CHAD, /**< Chad (Since 3.0) */
+       PHONE_NUMBER_REGION_TAJIKISTAN, /**< Tajikistan (Since 3.0) */
+       PHONE_NUMBER_REGION_TOKELAU, /**< Tokelau (Since 3.0) */
+       PHONE_NUMBER_REGION_TIMOR_LESTE,  /**< Timor-Leste (East Timor) (Since 3.0) */
+       PHONE_NUMBER_REGION_TURKMENISTAN, /**< Turkmenistan (Since 3.0) */
+       PHONE_NUMBER_REGION_TONGA, /**< Tonga (Since 3.0) */
+       PHONE_NUMBER_REGION_TUVALU, /**< Tuvalu (Since 3.0) */
+       PHONE_NUMBER_REGION_TANZANIA, /**< Tanzania (Since 3.0) */
+       PHONE_NUMBER_REGION_UKRAINE, /**< Ukraine (Since 3.0) */
+       PHONE_NUMBER_REGION_URUGUAY, /**< Uruguay (Since 3.0) */
+       PHONE_NUMBER_REGION_UZBEKISTAN, /**< Uzbekistan (Since 3.0) */
+       PHONE_NUMBER_REGION_VATICAN_CITY,  /**< Vatican City (Since 3.0) */
+       PHONE_NUMBER_REGION_VANUATU, /**< Vanuatu (Since 3.0) */
+       PHONE_NUMBER_REGION_WALLIS_AND_FUTUNA, /**< Wallis and Futuna (Territoire francais d'outre-mer) (Since 3.0) */
+       PHONE_NUMBER_REGION_SAMOA, /**< Samoa (Since 3.0) */
+       PHONE_NUMBER_REGION_YEMEN, /**< Yemen (Since 3.0) */
+       PHONE_NUMBER_REGION_MAYOTTE, /**< Mayotte (Since 3.0) */
+       PHONE_NUMBER_REGION_SYSTEM, /**< Current System Value (Since 3.0) */
        PHONE_NUMBER_REGION_MAX,
 } phone_number_region_e;