diff --git a/telephony/java/android/telephony/TelephonyManager.java b/telephony/java/android/telephony/TelephonyManager.java index 58cf8fd293ea3..e0896b61048ea 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());