Loading api/current.txt +1 −0 Original line number Original line Diff line number Diff line Loading @@ -28647,6 +28647,7 @@ package android.telephony { method public static java.lang.String formatNumber(java.lang.String, java.lang.String); method public static java.lang.String formatNumber(java.lang.String, java.lang.String); method public static java.lang.String formatNumber(java.lang.String, java.lang.String, java.lang.String); method public static java.lang.String formatNumber(java.lang.String, java.lang.String, java.lang.String); method public static java.lang.String formatNumberToE164(java.lang.String, java.lang.String); method public static java.lang.String formatNumberToE164(java.lang.String, java.lang.String); method public static java.lang.String formatNumberToRFC3966(java.lang.String, java.lang.String); method public static deprecated int getFormatTypeForLocale(java.util.Locale); method public static deprecated int getFormatTypeForLocale(java.util.Locale); method public static java.lang.String getNumberFromIntent(android.content.Intent, android.content.Context); method public static java.lang.String getNumberFromIntent(android.content.Intent, android.content.Context); method public static java.lang.String getStrippedReversed(java.lang.String); method public static java.lang.String getStrippedReversed(java.lang.String); telephony/java/android/telephony/PhoneNumberUtils.java +46 −20 Original line number Original line Diff line number Diff line Loading @@ -1145,6 +1145,7 @@ public class PhoneNumberUtils * * * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead */ */ @Deprecated public static String formatNumber(String source) { public static String formatNumber(String source) { SpannableStringBuilder text = new SpannableStringBuilder(source); SpannableStringBuilder text = new SpannableStringBuilder(source); formatNumber(text, getFormatTypeForLocale(Locale.getDefault())); formatNumber(text, getFormatTypeForLocale(Locale.getDefault())); Loading @@ -1163,6 +1164,7 @@ public class PhoneNumberUtils * @hide * @hide * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead */ */ @Deprecated public static String formatNumber(String source, int defaultFormattingType) { public static String formatNumber(String source, int defaultFormattingType) { SpannableStringBuilder text = new SpannableStringBuilder(source); SpannableStringBuilder text = new SpannableStringBuilder(source); formatNumber(text, defaultFormattingType); formatNumber(text, defaultFormattingType); Loading @@ -1178,6 +1180,7 @@ public class PhoneNumberUtils * * * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead */ */ @Deprecated public static int getFormatTypeForLocale(Locale locale) { public static int getFormatTypeForLocale(Locale locale) { String country = locale.getCountry(); String country = locale.getCountry(); Loading @@ -1194,6 +1197,7 @@ public class PhoneNumberUtils * * * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead */ */ @Deprecated public static void formatNumber(Editable text, int defaultFormattingType) { public static void formatNumber(Editable text, int defaultFormattingType) { int formatType = defaultFormattingType; int formatType = defaultFormattingType; Loading Loading @@ -1242,6 +1246,7 @@ public class PhoneNumberUtils * * * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead */ */ @Deprecated public static void formatNanpNumber(Editable text) { public static void formatNanpNumber(Editable text) { int length = text.length(); int length = text.length(); if (length > "+1-nnn-nnn-nnnn".length()) { if (length > "+1-nnn-nnn-nnnn".length()) { Loading Loading @@ -1357,6 +1362,7 @@ public class PhoneNumberUtils * * * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead */ */ @Deprecated public static void formatJapaneseNumber(Editable text) { public static void formatJapaneseNumber(Editable text) { JapanesePhoneNumberFormatter.format(text); JapanesePhoneNumberFormatter.format(text); } } Loading @@ -1378,32 +1384,52 @@ public class PhoneNumberUtils } } /** /** * Format the given phoneNumber to the E.164 representation. * Formats the specified {@code phoneNumber} to the E.164 representation. * * @param phoneNumber the phone number to format. * @param defaultCountryIso the ISO 3166-1 two letters country code. * @return the E.164 representation, or null if the given phone number is not valid. */ public static String formatNumberToE164(String phoneNumber, String defaultCountryIso) { return formatNumberInternal(phoneNumber, defaultCountryIso, PhoneNumberFormat.E164); } /** * Formats the specified {@code phoneNumber} to the RFC3966 representation. * * @param phoneNumber the phone number to format. * @param defaultCountryIso the ISO 3166-1 two letters country code. * @return the RFC3966 representation, or null if the given phone number is not valid. */ public static String formatNumberToRFC3966(String phoneNumber, String defaultCountryIso) { return formatNumberInternal(phoneNumber, defaultCountryIso, PhoneNumberFormat.RFC3966); } /** * Formats the raw phone number (string) using the specified {@code formatIdentifier}. * <p> * <p> * The given phone number must have an area code and could have a country * The given phone number must have an area code and could have a country code. * code. * <p> * <p> * The defaultCountryIso is used to validate the given number and generate * The defaultCountryIso is used to validate the given number and generate the formatted number * the E.164 phone number if the given number doesn't have a country code. * if the specified number doesn't have a country code. * * * @param phoneNumber * @param rawPhoneNumber The phone number to format. * the phone number to format * @param defaultCountryIso The ISO 3166-1 two letters country code. * @param defaultCountryIso * @param formatIdentifier The (enum) identifier of the desired format. * the ISO 3166-1 two letters country code * @return the formatted representation, or null if the specified number is not valid. * @return the E.164 representation, or null if the given phone number is * not valid. */ */ public static String formatNumberToE164(String phoneNumber, String defaultCountryIso) { private static String formatNumberInternal( String rawPhoneNumber, String defaultCountryIso, PhoneNumberFormat formatIdentifier) { PhoneNumberUtil util = PhoneNumberUtil.getInstance(); PhoneNumberUtil util = PhoneNumberUtil.getInstance(); String result = null; try { try { PhoneNumber pn = util.parse(phoneNumber, defaultCountryIso); PhoneNumber phoneNumber = util.parse(rawPhoneNumber, defaultCountryIso); if (util.isValidNumber(pn)) { if (util.isValidNumber(phoneNumber)) { result = util.format(pn, PhoneNumberFormat.E164); return util.format(phoneNumber, formatIdentifier); } } } catch (NumberParseException e) { } catch (NumberParseException ignored) { } } return result; return null; } } /** /** Loading Loading @@ -2454,7 +2480,7 @@ public class PhoneNumberUtils * * * @param number SIP address of the form "username@domainname" * @param number SIP address of the form "username@domainname" * (or the URI-escaped equivalent "username%40domainname") * (or the URI-escaped equivalent "username%40domainname") * @see isUriNumber * @see #isUriNumber * * * @hide * @hide */ */ Loading Loading
api/current.txt +1 −0 Original line number Original line Diff line number Diff line Loading @@ -28647,6 +28647,7 @@ package android.telephony { method public static java.lang.String formatNumber(java.lang.String, java.lang.String); method public static java.lang.String formatNumber(java.lang.String, java.lang.String); method public static java.lang.String formatNumber(java.lang.String, java.lang.String, java.lang.String); method public static java.lang.String formatNumber(java.lang.String, java.lang.String, java.lang.String); method public static java.lang.String formatNumberToE164(java.lang.String, java.lang.String); method public static java.lang.String formatNumberToE164(java.lang.String, java.lang.String); method public static java.lang.String formatNumberToRFC3966(java.lang.String, java.lang.String); method public static deprecated int getFormatTypeForLocale(java.util.Locale); method public static deprecated int getFormatTypeForLocale(java.util.Locale); method public static java.lang.String getNumberFromIntent(android.content.Intent, android.content.Context); method public static java.lang.String getNumberFromIntent(android.content.Intent, android.content.Context); method public static java.lang.String getStrippedReversed(java.lang.String); method public static java.lang.String getStrippedReversed(java.lang.String);
telephony/java/android/telephony/PhoneNumberUtils.java +46 −20 Original line number Original line Diff line number Diff line Loading @@ -1145,6 +1145,7 @@ public class PhoneNumberUtils * * * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead */ */ @Deprecated public static String formatNumber(String source) { public static String formatNumber(String source) { SpannableStringBuilder text = new SpannableStringBuilder(source); SpannableStringBuilder text = new SpannableStringBuilder(source); formatNumber(text, getFormatTypeForLocale(Locale.getDefault())); formatNumber(text, getFormatTypeForLocale(Locale.getDefault())); Loading @@ -1163,6 +1164,7 @@ public class PhoneNumberUtils * @hide * @hide * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead */ */ @Deprecated public static String formatNumber(String source, int defaultFormattingType) { public static String formatNumber(String source, int defaultFormattingType) { SpannableStringBuilder text = new SpannableStringBuilder(source); SpannableStringBuilder text = new SpannableStringBuilder(source); formatNumber(text, defaultFormattingType); formatNumber(text, defaultFormattingType); Loading @@ -1178,6 +1180,7 @@ public class PhoneNumberUtils * * * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead */ */ @Deprecated public static int getFormatTypeForLocale(Locale locale) { public static int getFormatTypeForLocale(Locale locale) { String country = locale.getCountry(); String country = locale.getCountry(); Loading @@ -1194,6 +1197,7 @@ public class PhoneNumberUtils * * * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead */ */ @Deprecated public static void formatNumber(Editable text, int defaultFormattingType) { public static void formatNumber(Editable text, int defaultFormattingType) { int formatType = defaultFormattingType; int formatType = defaultFormattingType; Loading Loading @@ -1242,6 +1246,7 @@ public class PhoneNumberUtils * * * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead */ */ @Deprecated public static void formatNanpNumber(Editable text) { public static void formatNanpNumber(Editable text) { int length = text.length(); int length = text.length(); if (length > "+1-nnn-nnn-nnnn".length()) { if (length > "+1-nnn-nnn-nnnn".length()) { Loading Loading @@ -1357,6 +1362,7 @@ public class PhoneNumberUtils * * * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead * @deprecated Use link #formatNumber(String phoneNumber, String defaultCountryIso) instead */ */ @Deprecated public static void formatJapaneseNumber(Editable text) { public static void formatJapaneseNumber(Editable text) { JapanesePhoneNumberFormatter.format(text); JapanesePhoneNumberFormatter.format(text); } } Loading @@ -1378,32 +1384,52 @@ public class PhoneNumberUtils } } /** /** * Format the given phoneNumber to the E.164 representation. * Formats the specified {@code phoneNumber} to the E.164 representation. * * @param phoneNumber the phone number to format. * @param defaultCountryIso the ISO 3166-1 two letters country code. * @return the E.164 representation, or null if the given phone number is not valid. */ public static String formatNumberToE164(String phoneNumber, String defaultCountryIso) { return formatNumberInternal(phoneNumber, defaultCountryIso, PhoneNumberFormat.E164); } /** * Formats the specified {@code phoneNumber} to the RFC3966 representation. * * @param phoneNumber the phone number to format. * @param defaultCountryIso the ISO 3166-1 two letters country code. * @return the RFC3966 representation, or null if the given phone number is not valid. */ public static String formatNumberToRFC3966(String phoneNumber, String defaultCountryIso) { return formatNumberInternal(phoneNumber, defaultCountryIso, PhoneNumberFormat.RFC3966); } /** * Formats the raw phone number (string) using the specified {@code formatIdentifier}. * <p> * <p> * The given phone number must have an area code and could have a country * The given phone number must have an area code and could have a country code. * code. * <p> * <p> * The defaultCountryIso is used to validate the given number and generate * The defaultCountryIso is used to validate the given number and generate the formatted number * the E.164 phone number if the given number doesn't have a country code. * if the specified number doesn't have a country code. * * * @param phoneNumber * @param rawPhoneNumber The phone number to format. * the phone number to format * @param defaultCountryIso The ISO 3166-1 two letters country code. * @param defaultCountryIso * @param formatIdentifier The (enum) identifier of the desired format. * the ISO 3166-1 two letters country code * @return the formatted representation, or null if the specified number is not valid. * @return the E.164 representation, or null if the given phone number is * not valid. */ */ public static String formatNumberToE164(String phoneNumber, String defaultCountryIso) { private static String formatNumberInternal( String rawPhoneNumber, String defaultCountryIso, PhoneNumberFormat formatIdentifier) { PhoneNumberUtil util = PhoneNumberUtil.getInstance(); PhoneNumberUtil util = PhoneNumberUtil.getInstance(); String result = null; try { try { PhoneNumber pn = util.parse(phoneNumber, defaultCountryIso); PhoneNumber phoneNumber = util.parse(rawPhoneNumber, defaultCountryIso); if (util.isValidNumber(pn)) { if (util.isValidNumber(phoneNumber)) { result = util.format(pn, PhoneNumberFormat.E164); return util.format(phoneNumber, formatIdentifier); } } } catch (NumberParseException e) { } catch (NumberParseException ignored) { } } return result; return null; } } /** /** Loading Loading @@ -2454,7 +2480,7 @@ public class PhoneNumberUtils * * * @param number SIP address of the form "username@domainname" * @param number SIP address of the form "username@domainname" * (or the URI-escaped equivalent "username%40domainname") * (or the URI-escaped equivalent "username%40domainname") * @see isUriNumber * @see #isUriNumber * * * @hide * @hide */ */ Loading