Phonenumber utils

---

Required Header

#include <phone_number.h>

Overview

The phonenumber utils API provides methods for parsing and formatting phone numbers.

Related Features

This API is related with the following feature:

• http://tizen.org/feature/network.telephony
  It is recommended to design feature related codes in your application for reliability.
  You can check if a device supports the related features for this API by using System Information, thereby controlling the procedure of your application.
  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.
  More details on featuring your application can be found from Feature Element.

Functions
int	phone_number_connect (void)
	Connects to the phonenumber-utils service.
int	phone_number_disconnect (void)
	Disconnects from the phonenumber-utils service.
int	phone_number_get_location_from_number (const char *number, phone_number_region_e region, phone_number_lang_e language, char **location)
	Gets the location string from number, region, and language.
int	phone_number_get_formatted_number (const char *number, phone_number_region_e region, char **formatted_number)
	Gets the formatted number.
int	phone_number_get_normalized_number (const char *number, char **normalized_number)
	Gets the normalized number.
int	phone_number_add_blocking_rule (phone_number_blocking_rule_h rule)
	Adds a blocking rule to the phone number database.
int	phone_number_remove_blocking_rule (phone_number_blocking_rule_h rule)
	Removes a blocking rule from the phone number database.
int	phone_number_get_blocking_rules (int offset, int limit, phone_number_blocking_rule_h **rules, int *length)
	Retrieves blocking rules as an array.
int	phone_number_get_blocking_rules_related (const char *number, phone_number_blocking_rule_h **rules, int *length)
	Retrieves blocking rules that block a specific number.
int	phone_number_check_blocking (const char *number, bool *is_blocked)
	Checks if a specific number is blocked or not.
int	phone_number_blocking_rule_create (phone_number_blocking_rule_h *rule)
	Creates a blocking rule.
int	phone_number_blocking_rule_destroy (phone_number_blocking_rule_h rule)
	Destroys a blocking rule and releases all its resources.
int	phone_number_blocking_rule_get_number (phone_number_blocking_rule_h rule, char **number)
	Gets a blocked number from a rule.
int	phone_number_blocking_rule_get_match_type (phone_number_blocking_rule_h rule, phone_number_blocking_rule_match_type_e *match_type)
	Gets a rule's match type.
int	phone_number_blocking_rule_set_number (phone_number_blocking_rule_h rule, const char *number)
	Sets a blocked number to a rule.
int	phone_number_blocking_rule_set_match_type (phone_number_blocking_rule_h rule, phone_number_blocking_rule_match_type_e match_type)
	Sets a rule's match type.
Typedefs
typedef void *	phone_number_blocking_rule_h
	The blocking rule handle.

---

Typedef Documentation

typedef void* phone_number_blocking_rule_h

The blocking rule handle.

Since :

4.0

---

Enumeration Type Documentation

enum phone_number_blocking_rule_match_type_e

Enumeration for match type.

Since :

4.0

Enumerator:

PHONE_NUMBER_MATCH_TYPE_EXACTLY	Exact match
PHONE_NUMBER_MATCH_TYPE_INCLUDES	Includes
PHONE_NUMBER_MATCH_TYPE_STARTS_WITH	Starts with
PHONE_NUMBER_MATCH_TYPE_ENDS_WITH	Ends with

enum phone_number_error_e

Enumeration for phone number errors.

Since :

2.4

Enumerator:

PHONE_NUMBER_ERROR_NONE	Successful
PHONE_NUMBER_ERROR_IO_ERROR	I/O Error
PHONE_NUMBER_ERROR_OUT_OF_MEMORY	Out of memory
PHONE_NUMBER_ERROR_INVALID_PARAMETER	Invalid parameter
PHONE_NUMBER_ERROR_FILE_NO_SPACE_ON_DEVICE	FS Full
PHONE_NUMBER_ERROR_PERMISSION_DENIED	Permission denied
PHONE_NUMBER_ERROR_NOT_SUPPORTED	Not supported
PHONE_NUMBER_ERROR_NO_DATA	Requested data does not exist
PHONE_NUMBER_ERROR_SYSTEM	Internal error (Since 3.0)
PHONE_NUMBER_ERROR_DB_FAILED	No access to the database (Since 4.0)
PHONE_NUMBER_ERROR_IPC	Unknown IPC error (Since 4.0)

enum phone_number_lang_e

Enumeration for language type.

Since :

2.4

Enumerator:

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)

enum phone_number_region_e

Enumeration for region type.

Since :

2.4

Enumerator:

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	Chinese Taiwan
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	Chinese 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)

---

Function Documentation

int phone_number_add_blocking_rule

(

phone_number_blocking_rule_h

rule

)

Adds a blocking rule to the phone number database.

Since :

4.0

Privilege Level:

partner

Privilege:

http://tizen.org/privilege/blocknumber.write

Parameters:

[in]

rule

The blocking rule handle

Returns:

0 on success, otherwise a negative error value

Return values:

PHONE_NUMBER_ERROR_NONE	Successful
PHONE_NUMBER_ERROR_INVALID_PARAMETER	Invalid parameter
PHONE_NUMBER_ERROR_DB_FAILED	Database operation failure
PHONE_NUMBER_ERROR_PERMISSION_DENIED	Permission denied. This application does not have the privilege to call this method.
PHONE_NUMBER_ERROR_NOT_SUPPORTED	Not supported
PHONE_NUMBER_ERROR_IPC	Unknown IPC error
PHONE_NUMBER_ERROR_OUT_OF_MEMORY	Out of memory
PHONE_NUMBER_ERROR_SYSTEM	Internal error

Precondition:

phone_number_connect() should be called to open a connection to the phonenumber-utils service.

Postcondition:

phone_number_disconnect() should be called to close a connection to the phonenumber-utils service.

See also:

phone_number_remove_blocking_rule()

int phone_number_blocking_rule_create

(

phone_number_blocking_rule_h *

rule

)

Creates a blocking rule.

Since :

4.0

Remarks:

You must release rule using phone_number_blocking_rule_destroy().

Parameters:

[out]

rule

The blocking rule handle

Returns:

0 on success, otherwise a negative error value

Return values:

PHONE_NUMBER_ERROR_NONE	Successful
PHONE_NUMBER_ERROR_OUT_OF_MEMORY	Out of memory
PHONE_NUMBER_ERROR_INVALID_PARAMETER	Invalid parameter
PHONE_NUMBER_ERROR_NOT_SUPPORTED	Not supported
PHONE_NUMBER_ERROR_SYSTEM	Internal error

Precondition:

phone_number_connect() should be called to initialize.

See also:

phone_number_blocking_rule_destroy()

int phone_number_blocking_rule_destroy

(

phone_number_blocking_rule_h

rule

)

Destroys a blocking rule and releases all its resources.

Since :

4.0

Parameters:

[in]

rule

The blocking rule handle

Returns:

0 on success, otherwise a negative error value

Return values:

PHONE_NUMBER_ERROR_NONE	Successful
PHONE_NUMBER_ERROR_INVALID_PARAMETER	Invalid parameter
PHONE_NUMBER_ERROR_NOT_SUPPORTED	Not supported
PHONE_NUMBER_ERROR_SYSTEM	Internal error

See also:

phone_number_blocking_rule_create()

int phone_number_blocking_rule_get_match_type	(	phone_number_blocking_rule_h	rule,
		phone_number_blocking_rule_match_type_e *	match_type
	)

Gets a rule's match type.

Since :

4.0

Parameters:

[in]	rule	The blocking rule handle
[out]	match_type	The match type of blocked number

Returns:

0 on success, otherwise a negative error value

Return values:

PHONE_NUMBER_ERROR_NONE	Successful
PHONE_NUMBER_ERROR_INVALID_PARAMETER	Invalid parameter
PHONE_NUMBER_ERROR_NOT_SUPPORTED	Not supported
PHONE_NUMBER_ERROR_SYSTEM	Internal error

See also:

phone_number_blocking_rule_set_match_type()

int phone_number_blocking_rule_get_number	(	phone_number_blocking_rule_h	rule,
		char **	number
	)

Gets a blocked number from a rule.

Since :

4.0

Remarks:

You must release number using free().

Parameters:

[in]	rule	The blocking rule handle
[out]	number	The blocked number

Returns:

0 on success, otherwise a negative error value

Return values:

PHONE_NUMBER_ERROR_NONE	Successful
PHONE_NUMBER_ERROR_INVALID_PARAMETER	Invalid parameter
PHONE_NUMBER_ERROR_NOT_SUPPORTED	Not supported
PHONE_NUMBER_ERROR_SYSTEM	Internal error

See also:

phone_number_blocking_rule_set_number()

int phone_number_blocking_rule_set_match_type	(	phone_number_blocking_rule_h	rule,
		phone_number_blocking_rule_match_type_e	match_type
	)

Sets a rule's match type.

Since :

4.0

Parameters:

[in]	rule	The blocking rule handle
[in]	match_type	The match type of blocked number

Returns:

0 on success, otherwise a negative error value

Return values:

PHONE_NUMBER_ERROR_NONE	Successful
PHONE_NUMBER_ERROR_INVALID_PARAMETER	Invalid parameter
PHONE_NUMBER_ERROR_NOT_SUPPORTED	Not supported
PHONE_NUMBER_ERROR_SYSTEM	Internal error

See also:

phone_number_blocking_rule_get_match_type()

int phone_number_blocking_rule_set_number	(	phone_number_blocking_rule_h	rule,
		const char *	number
	)

Sets a blocked number to a rule.

Since :

4.0

Parameters:

[in]	rule	The blocking rule handle
[in]	number	The blocked number

Returns:

0 on success, otherwise a negative error value

Return values:

PHONE_NUMBER_ERROR_NONE	Successful
PHONE_NUMBER_ERROR_INVALID_PARAMETER	Invalid parameter
PHONE_NUMBER_ERROR_NOT_SUPPORTED	Not supported
PHONE_NUMBER_ERROR_SYSTEM	Internal error

See also:

phone_number_blocking_rule_get_number()

int phone_number_check_blocking	(	const char *	number,
		bool *	is_blocked
	)

Checks if a specific number is blocked or not.

Since :

4.0

Privilege Level:

partner

Privilege:

http://tizen.org/privilege/blocknumber.read

Parameters:

[in]	number	The number to check blocking
[out]	is_blocked	The blocking result

Returns:

0 on success, otherwise a negative error value

Return values:

PHONE_NUMBER_ERROR_NONE	Successful
PHONE_NUMBER_ERROR_INVALID_PARAMETER	Invalid parameter
PHONE_NUMBER_ERROR_DB_FAILED	Database operation failure
PHONE_NUMBER_ERROR_PERMISSION_DENIED	Permission denied. This application does not have the privilege to call this method.
PHONE_NUMBER_ERROR_NOT_SUPPORTED	Not supported
PHONE_NUMBER_ERROR_IPC	Unknown IPC error
PHONE_NUMBER_ERROR_SYSTEM	Internal error

Precondition:

phone_number_connect() should be called to open a connection to the phonenumber-utils service.

Postcondition:

phone_number_disconnect() should be called to close a connection to the phonenumber-utils service.

int phone_number_connect

(

void

)

Connects to the phonenumber-utils service.

Since :

3.0

Returns:

0 on success, otherwise a negative error value

Return values:

PHONE_NUMBER_ERROR_NONE	Successful
PHONE_NUMBER_ERROR_NOT_SUPPORTED	Not supported
PHONE_NUMBER_ERROR_SYSTEM	Internal error

See also:

phone_number_disconnect()

int phone_number_disconnect

(

void

)

Disconnects from the phonenumber-utils service.

Since :

3.0

Returns:

0 on success, otherwise a negative error value

Return values:

PHONE_NUMBER_ERROR_NONE	Successful
PHONE_NUMBER_ERROR_NOT_SUPPORTED	Not supported
PHONE_NUMBER_ERROR_SYSTEM	Internal error

See also:

phone_number_connect()

int phone_number_get_blocking_rules	(	int	offset,
		int	limit,
		phone_number_blocking_rule_h **	rules,
		int *	length
	)

Retrieves blocking rules as an array.

Since :

4.0

Privilege Level:

partner

Privilege:

http://tizen.org/privilege/blocknumber.read

Remarks:

You must release each blocking rule in the array with phone_number_blocking_rule_destroy() and rules using free().

Parameters:

[in]	offset	The index from which to get results
[in]	limit	The number to limit results (value 0 is used for all blocking rules)
[out]	rules	The array of blocking rule handles
[out]	length	The number of blocking rule handles in the array

Returns:

0 on success, otherwise a negative error value

Return values:

PHONE_NUMBER_ERROR_NONE	Successful
PHONE_NUMBER_ERROR_OUT_OF_MEMORY	Out of memory
PHONE_NUMBER_ERROR_INVALID_PARAMETER	Invalid parameter
PHONE_NUMBER_ERROR_DB_FAILED	Database operation failure
PHONE_NUMBER_ERROR_PERMISSION_DENIED	Permission denied. This application does not have the privilege to call this method.
PHONE_NUMBER_ERROR_NOT_SUPPORTED	Not supported
PHONE_NUMBER_ERROR_IPC	Unknown IPC error
PHONE_NUMBER_ERROR_NO_DATA	Data does not exist
PHONE_NUMBER_ERROR_SYSTEM	Internal error

Precondition:

phone_number_connect() should be called to open a connection to the phonenumber-utils service.

Postcondition:

phone_number_disconnect() should be called to close a connection to the phonenumber-utils service.

int phone_number_get_blocking_rules_related	(	const char *	number,
		phone_number_blocking_rule_h **	rules,
		int *	length
	)

Retrieves blocking rules that block a specific number.

Since :

4.0

Privilege Level:

partner

Privilege:

http://tizen.org/privilege/blocknumber.read

Remarks:

You must release each blocking rule in the array with phone_number_blocking_rule_destroy() and rules using free().

Parameters:

[in]	number	The number to get blocking rules related with
[out]	rules	The array of blocking rule handles
[out]	length	The number of blocking rule handles in the array

Returns:

0 on success, otherwise a negative error value

Return values:

PHONE_NUMBER_ERROR_NONE	Successful
PHONE_NUMBER_ERROR_OUT_OF_MEMORY	Out of memory
PHONE_NUMBER_ERROR_INVALID_PARAMETER	Invalid parameter
PHONE_NUMBER_ERROR_DB_FAILED	Database operation failure
PHONE_NUMBER_ERROR_PERMISSION_DENIED	Permission denied. This application does not have the privilege to call this method.
PHONE_NUMBER_ERROR_NOT_SUPPORTED	Not supported
PHONE_NUMBER_ERROR_IPC	Unknown IPC error
PHONE_NUMBER_ERROR_NO_DATA	Data does not exist
PHONE_NUMBER_ERROR_SYSTEM	Internal error

Precondition:

phone_number_connect() should be called to open a connection to the phonenumber-utils service.

Postcondition:

phone_number_disconnect() should be called to close a connection to the phonenumber-utils service.

int phone_number_get_formatted_number	(	const char *	number,
		phone_number_region_e	region,
		char **	formatted_number
	)

Gets the formatted number.

Since :

2.4

Remarks:

You must release formatted_number using free().

The phonenumber-utils is changed to client/server architecture for performance improvement since 3.0. phone_number_connect()/phone_number_disconnect() should be called.

Parameters:

[in]	number	The number
[in]	region	The region of number
[out]	formatted_number	The formatted number string to be returned

Returns:

0 on success, otherwise a negative error value

Return values:

PHONE_NUMBER_ERROR_NONE	Successful
PHONE_NUMBER_ERROR_OUT_OF_MEMORY	Out of memory
PHONE_NUMBER_ERROR_INVALID_PARAMETER	Invalid parameter
PHONE_NUMBER_ERROR_FILE_NO_SPACE_ON_DEVICE	FS Full
PHONE_NUMBER_ERROR_PERMISSION_DENIED	Permission denied
PHONE_NUMBER_ERROR_NOT_SUPPORTED	Not supported
PHONE_NUMBER_ERROR_NO_DATA	Requested data does not exist
PHONE_NUMBER_ERROR_SYSTEM	Internal error

Precondition:

phone_number_connect() should be called to open a connection to the phonenumber-utils service. (Since 3.0)

Postcondition:

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
	)

Gets the location string from number, region, and language.

Since :

2.4

Remarks:

You must release location using free().

The phonenumber-utils is changed to client/server architecture for performance improvement since 3.0. phone_number_connect()/phone_number_disconnect() should be called.

Parameters:

[in]	number	The number
[in]	region	The region of number
[in]	language	The language of location
[out]	location	The location string to be returned

Returns:

0 on success, otherwise a negative error value

Return values:

PHONE_NUMBER_ERROR_NONE	Successful
PHONE_NUMBER_ERROR_OUT_OF_MEMORY	Out of memory
PHONE_NUMBER_ERROR_INVALID_PARAMETER	Invalid parameter
PHONE_NUMBER_ERROR_FILE_NO_SPACE_ON_DEVICE	FS Full
PHONE_NUMBER_ERROR_PERMISSION_DENIED	Permission denied
PHONE_NUMBER_ERROR_NOT_SUPPORTED	Not supported
PHONE_NUMBER_ERROR_NO_DATA	Requested data does not exist
PHONE_NUMBER_ERROR_SYSTEM	Internal error

Precondition:

phone_number_connect() should be called to open a connection to the phonenumber-utils service. (Since 3.0)

Postcondition:

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
	)

Gets the normalized number.

Normalized number starts with plus('+') and country code, and excludes the separators such as dash or space. It is a format of E.164 standard including the country code based on current network.

Since :

3.0

Privilege Level:

public

Privilege:

http://tizen.org/privilege/telephony

Remarks:

You must release normalized_number using free().

The phonenumber-utils is changed to client/server architecture for performance improvement since 3.0. phone_number_connect()/phone_number_disconnect() should be called.

Parameters:

[in]	number	The number
[out]	normalized_number	The normalized number string to be returned

Returns:

0 on success, otherwise a negative error value

Return values:

PHONE_NUMBER_ERROR_NONE	Successful
PHONE_NUMBER_ERROR_OUT_OF_MEMORY	Out of memory
PHONE_NUMBER_ERROR_INVALID_PARAMETER	Invalid parameter
PHONE_NUMBER_ERROR_PERMISSION_DENIED	Permission denied
PHONE_NUMBER_ERROR_NOT_SUPPORTED	Not supported
PHONE_NUMBER_ERROR_NO_DATA	Requested data does not exist
PHONE_NUMBER_ERROR_SYSTEM	Internal error

Precondition:

phone_number_connect() should be called to open a connection to the phonenumber-utils service. (Since 3.0)

Postcondition:

phone_number_disconnect() should be called to close a connection to the phonenumber-utils service. (Since 3.0)

int phone_number_remove_blocking_rule

(

phone_number_blocking_rule_h

rule

)

Removes a blocking rule from the phone number database.

Since :

4.0

Privilege Level:

partner

Privilege:

http://tizen.org/privilege/blocknumber.write

Remarks:

The blocking rule to remove should have been gotten from the phone number database using phone_number_get_blocking_rules().

Parameters:

[in]

rule

The blocking rule handle

Returns:

0 on success, otherwise a negative error value

Return values:

PHONE_NUMBER_ERROR_NONE	Successful
PHONE_NUMBER_ERROR_INVALID_PARAMETER	Invalid parameter
PHONE_NUMBER_ERROR_DB_FAILED	Database operation failure
PHONE_NUMBER_ERROR_PERMISSION_DENIED	Permission denied. This application does not have the privilege to call this method.
PHONE_NUMBER_ERROR_NOT_SUPPORTED	Not supported
PHONE_NUMBER_ERROR_IPC	Unknown IPC error
PHONE_NUMBER_ERROR_OUT_OF_MEMORY	Out of memory
PHONE_NUMBER_ERROR_SYSTEM	Internal error

Precondition:

phone_number_connect() should be called to open a connection to the phonenumber-utils service.

Postcondition:

phone_number_disconnect() should be called to close a connection to the phonenumber-utils service.

See also:

phone_number_add_blocking_rule()