Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 031f56f2 authored by Automerger Merge Worker's avatar Automerger Merge Worker Committed by Tyler Gunn
Browse files

Update EmergencyNumber API docs to indicate they can throw. 

Adding @throws tags for EmergencyNumber APIs so that callers are aware
that they can throw.
Test: Build; docs only change.
Bug: 134100020
Fixes: 152231444

Merged-In: Ic6bcd32ab93a97a8d075e720acb5fc17612a3984
Change-Id: Ic6bcd32ab93a97a8d075e720acb5fc17612a3984
(cherry picked from commit 5fe27428)
parent b164ea9d

telephony/java/android/telephony/TelephonyManager.java

+3 −1
Original line number Diff line number Diff line
@@ -11776,6 +11776,7 @@ public class TelephonyManager { 
     * subscription, the key is {@link SubscriptionManager#getDefaultSubscriptionId}) and the value

     * as the list of {@link EmergencyNumber}; empty Map if this information is not available;

     * or throw a SecurityException if the caller does not have the permission.

     * @throws IllegalStateException if the Telephony process is not currently available.

     */

    @RequiresPermission(android.Manifest.permission.READ_PHONE_STATE)

    @NonNull
@@ -11823,6 +11824,7 @@ public class TelephonyManager { 
     * @param number - the number to look up

     * @return {@code true} if the given number is an emergency number based on current locale,

     * SIM card(s), Android database, modem, network or defaults; {@code false} otherwise.

     * @throws IllegalStateException if the Telephony process is not currently available.

     */

    public boolean isEmergencyNumber(@NonNull String number) {

        try {
@@ -11858,7 +11860,7 @@ public class TelephonyManager { 
     * the same digits of any current emergency number based on current locale, sim, modem and

     * network; {@code false} if it is not; or throw an SecurityException if the caller does not

     * have the required permission/privileges

     *

     * @throws IllegalStateException if the Telephony process is not currently available.

     * @hide

     */

    @SystemApi