PhoneNumberUtils

FORMAT_JAPAN

int FORMAT_JAPAN

Japanese formatting

Constant Value: 2 (0x00000002)

FORMAT_NANP

int FORMAT_NANP

NANP formatting

Constant Value: 1 (0x00000001)

FORMAT_UNKNOWN

int FORMAT_UNKNOWN

The current locale is unknown, look for a country code or don't format

Constant Value: 0 (0x00000000)

PAUSE

char PAUSE

Constant Value: 44 (0x0000002c)

TOA_International

int TOA_International

Constant Value: 145 (0x00000091)

TOA_Unknown

int TOA_Unknown

Constant Value: 129 (0x00000081)

WAIT

char WAIT

Constant Value: 59 (0x0000003b)

WILD

char WILD

Constant Value: 78 (0x0000004e)

PhoneNumberUtils

PhoneNumberUtils ()

addTtsSpan

void addTtsSpan (Spannable s, 
                int start, 
                int endExclusive)

Attach a TtsSpan to the supplied Spannable at the indicated location, annotating that location as containing a phone number.

calledPartyBCDFragmentToString

String calledPartyBCDFragmentToString (byte[] bytes, 
                int offset, 
                int length)

Like calledPartyBCDToString, but field does not start with a TOA byte. For example: SIM ADN extension fields

calledPartyBCDToString

String calledPartyBCDToString (byte[] bytes, 
                int offset, 
                int length)

3GPP TS 24.008 10.5.4.7 Called Party BCD Number See Also TS 51.011 10.5.1 "dialing number/ssc string" and TS 11.11 "10.3.1 EF adn (Abbreviated dialing numbers)"

compare

boolean compare (Context context, 
                String a, 
                String b)

Compare phone numbers a and b, and return true if they're identical enough for caller ID purposes. Checks a resource to determine whether to use a strict or loose comparison algorithm.

compare

boolean compare (String a, 
                String b)

Compare phone numbers a and b, return true if they're identical enough for caller ID purposes.

convertKeypadLettersToDigits

String convertKeypadLettersToDigits (String input)

Translates any alphabetic letters (i.e. [A-Za-z]) in the specified phone number into the equivalent numeric digits, according to the phone keypad letter mapping described in ITU E.161 and ISO/IEC 9995-8.

createTtsSpan

TtsSpan createTtsSpan (String phoneNumberString)

Create a TtsSpan for the supplied String.

createTtsSpannable

CharSequence createTtsSpannable (CharSequence phoneNumber)

Wrap the supplied CharSequence with a TtsSpan, annotating it as containing a phone number in its entirety.

extractNetworkPortion

String extractNetworkPortion (String phoneNumber)

Extracts the network address portion and canonicalizes (filters out separators.) Network address portion is everything up to DTMF control digit separators (pause or wait), but without non-dialable characters. Please note that the GSM wild character is allowed in the result. This must be resolved before dialing. Returns null if phoneNumber == null

extractPostDialPortion

String extractPostDialPortion (String phoneNumber)

Extracts the post-dial sequence of DTMF control digits, pauses, and waits. Strips separators. This string may be empty, but will not be null unless phoneNumber == null. Returns null if phoneNumber == null

formatJapaneseNumber

void formatJapaneseNumber (Editable text)

This method was deprecated in API level 21.
Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead

Formats a phone number in-place using the Japanese formatting rules. Numbers will be formatted as:

03-xxxx-xxxx 090-xxxx-xxxx 0120-xxx-xxx +81-3-xxxx-xxxx +81-90-xxxx-xxxx

formatNanpNumber

void formatNanpNumber (Editable text)

This method was deprecated in API level 21.
Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead

Formats a phone number in-place using the NANP formatting rules. Numbers will be formatted as:

xxxxx xxx-xxxx xxx-xxx-xxxx 1-xxx-xxx-xxxx +1-xxx-xxx-xxxx

formatNumber

String formatNumber (String phoneNumber, 
                String phoneNumberE164, 
                String defaultCountryIso)

Format the phone number only if the given number hasn't been formatted.

The number which has only dailable character is treated as not being formatted.

formatNumber

void formatNumber (Editable text, 
                int defaultFormattingType)

This method was deprecated in API level 21.
Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead

Formats a phone number in-place. Currently FORMAT_JAPAN and FORMAT_NANP is supported as a second argument.

formatNumber

String formatNumber (String source)

This method was deprecated in API level 21.
Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead

Breaks the given number down and formats it according to the rules for the country the number is from.

formatNumber

String formatNumber (String phoneNumber, 
                String defaultCountryIso)

Format a phone number.

If the given number doesn't have the country code, the phone will be formatted to the default country's convention.

formatNumberToE164

String formatNumberToE164 (String phoneNumber, 
                String defaultCountryIso)

Formats the specified phoneNumber to the E.164 representation.

formatNumberToRFC3966

String formatNumberToRFC3966 (String phoneNumber, 
                String defaultCountryIso)

Formats the specified phoneNumber to the RFC3966 representation.

getFormatTypeForLocale

int getFormatTypeForLocale (Locale locale)

This method was deprecated in API level 21.
Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead

Returns the phone number formatting type for the given locale.

getNumberFromIntent

String getNumberFromIntent (Intent intent, 
                Context context)

Extracts the phone number from an Intent.

getStrippedReversed

String getStrippedReversed (String phoneNumber)

Returns the network portion reversed. This string is intended to go into an index column for a database lookup. Returns null if phoneNumber == null

is12Key

boolean is12Key (char c)

True if c is ISO-LATIN characters 0-9, *, #

isDialable

boolean isDialable (char c)

True if c is ISO-LATIN characters 0-9, *, # , +, WILD

isEmergencyNumber

boolean isEmergencyNumber (String number)

Checks a given number against the list of emergency numbers provided by the RIL and SIM card.

isGlobalPhoneNumber

boolean isGlobalPhoneNumber (String phoneNumber)

isISODigit

boolean isISODigit (char c)

True if c is ISO-LATIN characters 0-9

isLocalEmergencyNumber

boolean isLocalEmergencyNumber (Context context, 
                String number)

Checks if a given number is an emergency number for the country that the user is in.

isNonSeparator

boolean isNonSeparator (char c)

True if c is ISO-LATIN characters 0-9, *, # , +, WILD, WAIT, PAUSE

isReallyDialable

boolean isReallyDialable (char c)

True if c is ISO-LATIN characters 0-9, *, # , + (no WILD)

isStartsPostDial

boolean isStartsPostDial (char c)

This any anything to the right of this char is part of the post-dial string (eg this is PAUSE or WAIT)

isVoiceMailNumber

boolean isVoiceMailNumber (String number)

isVoiceMailNumber: checks a given number against the voicemail number provided by the RIL and SIM card. The caller must have the READ_PHONE_STATE credential.

isWellFormedSmsAddress

boolean isWellFormedSmsAddress (String address)

Return true iff the network portion of address is, as far as we can tell on the device, suitable for use as an SMS destination address.

networkPortionToCalledPartyBCD

byte[] networkPortionToCalledPartyBCD (String s)

Note: calls extractNetworkPortion(), so do not use for SIM EF[ADN] style records Returns null if network portion is empty.

networkPortionToCalledPartyBCDWithLength

byte[] networkPortionToCalledPartyBCDWithLength (String s)

Same as networkPortionToCalledPartyBCD(String), but includes a one-byte length prefix.

normalizeNumber

String normalizeNumber (String phoneNumber)

Normalize a phone number by removing the characters other than digits. If the given number has keypad letters, the letters will be converted to digits first.

numberToCalledPartyBCD

byte[] numberToCalledPartyBCD (String number)

Convert a dialing number to BCD byte array

replaceUnicodeDigits

String replaceUnicodeDigits (String number)

Replaces all unicode(e.g. Arabic, Persian) digits with their decimal digit equivalents.

stringFromStringAndTOA

String stringFromStringAndTOA (String s, 
                int TOA)

Basically: makes sure there's a + in front of a TOA_International number Returns null if s == null

stripSeparators

String stripSeparators (String phoneNumber)

Strips separators from a phone number string.

toCallerIDMinMatch

String toCallerIDMinMatch (String phoneNumber)

Returns the rightmost MIN_MATCH (5) characters in the network portion in *reversed* order This can be used to do a database lookup against the column that stores getStrippedReversed() Returns null if phoneNumber == null

toaFromString

int toaFromString (String s)

Returns the TOA for the given dial string Basically, returns TOA_International if there's a + prefix