diff --git a/telephony/java/android/telephony/TelephonyManager.java b/telephony/java/android/telephony/TelephonyManager.java index 82cc1df08f4f4..add7d38edfdfa 100644 --- a/telephony/java/android/telephony/TelephonyManager.java +++ b/telephony/java/android/telephony/TelephonyManager.java @@ -2277,12 +2277,15 @@ public class TelephonyManager { } /** - * Returns the ISO country code equivalent of the MCC (Mobile Country Code) of the current + * Returns the ISO-3166 country code equivalent of the MCC (Mobile Country Code) of the current * registered operator or the cell nearby, if available. - * . + *
+ * The ISO-3166 country code is provided in lowercase 2 character format. *
* Note: Result may be unreliable on CDMA networks (use {@link #getPhoneType()} to determine * if on a CDMA network). + *
+ * @return the lowercase 2 character ISO-3166 country code, or empty string if not available. */ public String getNetworkCountryIso() { return getNetworkCountryIsoForPhone(getPhoneId()); @@ -3141,7 +3144,10 @@ public class TelephonyManager { } /** - * Returns the ISO country code equivalent for the SIM provider's country code. + * Returns the ISO-3166 country code equivalent for the SIM provider's country code. + *
+ * The ISO-3166 country code is provided in lowercase 2 character format. + * @return the lowercase 2 character ISO-3166 country code, or empty string is not available. */ public String getSimCountryIso() { return getSimCountryIsoForPhone(getPhoneId());