From 8d9f83ee09a7fa6982cf53351d6a11ae9e4d22e8 Mon Sep 17 00:00:00 2001
From: Jordan Liu <jminjie@google.com>
Date: Mon, 6 May 2019 16:38:27 -0700
Subject: [PATCH] Update getCardId doc with details

getCardId() returns the EID in some cases and ICCID in others. Add
comments explaining exactly when it returns what.

Test: no change in behavior
Bug: 131423779
Change-Id: Id0cbae3affdf4c034b2435bf77371ae1355d3cfa
---
 telephony/java/android/telephony/UiccSlotInfo.java | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/telephony/java/android/telephony/UiccSlotInfo.java b/telephony/java/android/telephony/UiccSlotInfo.java
index 93a7da04c56ed..2bc677562b782 100644
--- a/telephony/java/android/telephony/UiccSlotInfo.java
+++ b/telephony/java/android/telephony/UiccSlotInfo.java
@@ -140,6 +140,14 @@ public class UiccSlotInfo implements Parcelable {
         return mIsEuicc;
     }
 
+    /**
+     * Returns the ICCID of the card in the slot, or the EID of an active eUICC.
+     * <p>
+     * If the UICC slot is for an active eUICC, returns the EID.
+     * If the UICC slot is for an inactive eUICC, returns the ICCID of the enabled profile, or the
+     * root profile if all other profiles are disabled.
+     * If the UICC slot is not an eUICC, returns the ICCID.
+     */
     public String getCardId() {
         return mCardId;
     }