Tizen Native API  5.0
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:

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

The blocking rule handle.

Since :
4.0

Enumeration Type Documentation

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

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)

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)

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 

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_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

Adds a blocking rule to the phone number database.

Since :
4.0
Privilege Level:
partner
Privilege:
http://tizen.org/privilege/blocknumber.write
Parameters:
[in]ruleThe blocking rule handle
Returns:
0 on success, otherwise a negative error value
Return values:
PHONE_NUMBER_ERROR_NONESuccessful
PHONE_NUMBER_ERROR_INVALID_PARAMETERInvalid parameter
PHONE_NUMBER_ERROR_DB_FAILEDDatabase operation failure
PHONE_NUMBER_ERROR_PERMISSION_DENIEDPermission denied. This application does not have the privilege to call this method.
PHONE_NUMBER_ERROR_NOT_SUPPORTEDNot supported
PHONE_NUMBER_ERROR_IPCUnknown IPC error
PHONE_NUMBER_ERROR_OUT_OF_MEMORYOut of memory
PHONE_NUMBER_ERROR_SYSTEMInternal 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()

Creates a blocking rule.

Since :
4.0
Remarks:
You must release rule using phone_number_blocking_rule_destroy().
Parameters:
[out]ruleThe blocking rule handle
Returns:
0 on success, otherwise a negative error value
Return values:
PHONE_NUMBER_ERROR_NONESuccessful
PHONE_NUMBER_ERROR_OUT_OF_MEMORYOut of memory
PHONE_NUMBER_ERROR_INVALID_PARAMETERInvalid parameter
PHONE_NUMBER_ERROR_NOT_SUPPORTEDNot supported
PHONE_NUMBER_ERROR_SYSTEMInternal error
Precondition:
phone_number_connect() should be called to initialize.
See also:
phone_number_blocking_rule_destroy()

Destroys a blocking rule and releases all its resources.

Since :
4.0
Parameters:
[in]ruleThe blocking rule handle
Returns:
0 on success, otherwise a negative error value
Return values:
PHONE_NUMBER_ERROR_NONESuccessful
PHONE_NUMBER_ERROR_INVALID_PARAMETERInvalid parameter
PHONE_NUMBER_ERROR_NOT_SUPPORTEDNot supported
PHONE_NUMBER_ERROR_SYSTEMInternal error
See also:
phone_number_blocking_rule_create()

Gets a rule's match type.

Since :
4.0
Parameters:
[in]ruleThe blocking rule handle
[out]match_typeThe match type of blocked number
Returns:
0 on success, otherwise a negative error value
Return values:
PHONE_NUMBER_ERROR_NONESuccessful
PHONE_NUMBER_ERROR_INVALID_PARAMETERInvalid parameter
PHONE_NUMBER_ERROR_NOT_SUPPORTEDNot supported
PHONE_NUMBER_ERROR_SYSTEMInternal error
See also:
phone_number_blocking_rule_set_match_type()

Gets a blocked number from a rule.

Since :
4.0
Remarks:
You must release number using free().
Parameters:
[in]ruleThe blocking rule handle
[out]numberThe blocked number
Returns:
0 on success, otherwise a negative error value
Return values:
PHONE_NUMBER_ERROR_NONESuccessful
PHONE_NUMBER_ERROR_INVALID_PARAMETERInvalid parameter
PHONE_NUMBER_ERROR_NOT_SUPPORTEDNot supported
PHONE_NUMBER_ERROR_SYSTEMInternal error
See also:
phone_number_blocking_rule_set_number()

Sets a rule's match type.

Since :
4.0
Parameters:
[in]ruleThe blocking rule handle
[in]match_typeThe match type of blocked number
Returns:
0 on success, otherwise a negative error value
Return values:
PHONE_NUMBER_ERROR_NONESuccessful
PHONE_NUMBER_ERROR_INVALID_PARAMETERInvalid parameter
PHONE_NUMBER_ERROR_NOT_SUPPORTEDNot supported
PHONE_NUMBER_ERROR_SYSTEMInternal error
See also:
phone_number_blocking_rule_get_match_type()

Sets a blocked number to a rule.

Since :
4.0
Parameters:
[in]ruleThe blocking rule handle
[in]numberThe blocked number
Returns:
0 on success, otherwise a negative error value
Return values:
PHONE_NUMBER_ERROR_NONESuccessful
PHONE_NUMBER_ERROR_INVALID_PARAMETERInvalid parameter
PHONE_NUMBER_ERROR_NOT_SUPPORTEDNot supported
PHONE_NUMBER_ERROR_SYSTEMInternal 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]numberThe number to check blocking
[out]is_blockedThe blocking result
Returns:
0 on success, otherwise a negative error value
Return values:
PHONE_NUMBER_ERROR_NONESuccessful
PHONE_NUMBER_ERROR_INVALID_PARAMETERInvalid parameter
PHONE_NUMBER_ERROR_DB_FAILEDDatabase operation failure
PHONE_NUMBER_ERROR_PERMISSION_DENIEDPermission denied. This application does not have the privilege to call this method.
PHONE_NUMBER_ERROR_NOT_SUPPORTEDNot supported
PHONE_NUMBER_ERROR_IPCUnknown IPC error
PHONE_NUMBER_ERROR_SYSTEMInternal 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_NONESuccessful
PHONE_NUMBER_ERROR_NOT_SUPPORTEDNot supported
PHONE_NUMBER_ERROR_SYSTEMInternal 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_NONESuccessful
PHONE_NUMBER_ERROR_NOT_SUPPORTEDNot supported
PHONE_NUMBER_ERROR_SYSTEMInternal 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]offsetThe index from which to get results
[in]limitThe number to limit results (value 0 is used for all blocking rules)
[out]rulesThe array of blocking rule handles
[out]lengthThe number of blocking rule handles in the array
Returns:
0 on success, otherwise a negative error value
Return values:
PHONE_NUMBER_ERROR_NONESuccessful
PHONE_NUMBER_ERROR_OUT_OF_MEMORYOut of memory
PHONE_NUMBER_ERROR_INVALID_PARAMETERInvalid parameter
PHONE_NUMBER_ERROR_DB_FAILEDDatabase operation failure
PHONE_NUMBER_ERROR_PERMISSION_DENIEDPermission denied. This application does not have the privilege to call this method.
PHONE_NUMBER_ERROR_NOT_SUPPORTEDNot supported
PHONE_NUMBER_ERROR_IPCUnknown IPC error
PHONE_NUMBER_ERROR_NO_DATAData does not exist
PHONE_NUMBER_ERROR_SYSTEMInternal 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]numberThe number to get blocking rules related with
[out]rulesThe array of blocking rule handles
[out]lengthThe number of blocking rule handles in the array
Returns:
0 on success, otherwise a negative error value
Return values:
PHONE_NUMBER_ERROR_NONESuccessful
PHONE_NUMBER_ERROR_OUT_OF_MEMORYOut of memory
PHONE_NUMBER_ERROR_INVALID_PARAMETERInvalid parameter
PHONE_NUMBER_ERROR_DB_FAILEDDatabase operation failure
PHONE_NUMBER_ERROR_PERMISSION_DENIEDPermission denied. This application does not have the privilege to call this method.
PHONE_NUMBER_ERROR_NOT_SUPPORTEDNot supported
PHONE_NUMBER_ERROR_IPCUnknown IPC error
PHONE_NUMBER_ERROR_NO_DATAData does not exist
PHONE_NUMBER_ERROR_SYSTEMInternal 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]numberThe number
[in]regionThe region of number
[out]formatted_numberThe formatted number string to be returned
Returns:
0 on success, otherwise a negative error value
Return values:
PHONE_NUMBER_ERROR_NONESuccessful
PHONE_NUMBER_ERROR_OUT_OF_MEMORYOut of memory
PHONE_NUMBER_ERROR_INVALID_PARAMETERInvalid parameter
PHONE_NUMBER_ERROR_FILE_NO_SPACE_ON_DEVICEFS Full
PHONE_NUMBER_ERROR_PERMISSION_DENIEDPermission denied
PHONE_NUMBER_ERROR_NOT_SUPPORTEDNot supported
PHONE_NUMBER_ERROR_NO_DATARequested data does not exist
PHONE_NUMBER_ERROR_SYSTEMInternal 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]numberThe number
[in]regionThe region of number
[in]languageThe language of location
[out]locationThe location string to be returned
Returns:
0 on success, otherwise a negative error value
Return values:
PHONE_NUMBER_ERROR_NONESuccessful
PHONE_NUMBER_ERROR_OUT_OF_MEMORYOut of memory
PHONE_NUMBER_ERROR_INVALID_PARAMETERInvalid parameter
PHONE_NUMBER_ERROR_FILE_NO_SPACE_ON_DEVICEFS Full
PHONE_NUMBER_ERROR_PERMISSION_DENIEDPermission denied
PHONE_NUMBER_ERROR_NOT_SUPPORTEDNot supported
PHONE_NUMBER_ERROR_NO_DATARequested data does not exist
PHONE_NUMBER_ERROR_SYSTEMInternal 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]numberThe number
[out]normalized_numberThe normalized number string to be returned
Returns:
0 on success, otherwise a negative error value
Return values:
PHONE_NUMBER_ERROR_NONESuccessful
PHONE_NUMBER_ERROR_OUT_OF_MEMORYOut of memory
PHONE_NUMBER_ERROR_INVALID_PARAMETERInvalid parameter
PHONE_NUMBER_ERROR_PERMISSION_DENIEDPermission denied
PHONE_NUMBER_ERROR_NOT_SUPPORTEDNot supported
PHONE_NUMBER_ERROR_NO_DATARequested data does not exist
PHONE_NUMBER_ERROR_SYSTEMInternal 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)

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]ruleThe blocking rule handle
Returns:
0 on success, otherwise a negative error value
Return values:
PHONE_NUMBER_ERROR_NONESuccessful
PHONE_NUMBER_ERROR_INVALID_PARAMETERInvalid parameter
PHONE_NUMBER_ERROR_DB_FAILEDDatabase operation failure
PHONE_NUMBER_ERROR_PERMISSION_DENIEDPermission denied. This application does not have the privilege to call this method.
PHONE_NUMBER_ERROR_NOT_SUPPORTEDNot supported
PHONE_NUMBER_ERROR_IPCUnknown IPC error
PHONE_NUMBER_ERROR_OUT_OF_MEMORYOut of memory
PHONE_NUMBER_ERROR_SYSTEMInternal 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()