From e327160103293c94221f0e3e734d0f59d1aa8738 Mon Sep 17 00:00:00 2001 From: Nathan Harold Date: Mon, 24 Oct 2016 11:24:16 -0700 Subject: [PATCH] Update the docstring on getAllCellInfo() for unreported values In the event that not all fields are available for a particular cell information report, those values are set to Integer.MAX_VALUE. In addition, this docstring clarifies the minimum expectation for what will be reported in all cases. Bug: 32364031 Test: none Change-Id: Ic5df72f69e5917eb495d349a380ced53a80408fa --- telephony/java/android/telephony/TelephonyManager.java | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/telephony/java/android/telephony/TelephonyManager.java b/telephony/java/android/telephony/TelephonyManager.java index 0875ff975e103..4dab2bb0ff279 100644 --- a/telephony/java/android/telephony/TelephonyManager.java +++ b/telephony/java/android/telephony/TelephonyManager.java @@ -2952,7 +2952,10 @@ public class TelephonyManager { * methods may return true. * *

This method returns valid data for registered cells on devices with - * {@link android.content.pm.PackageManager#FEATURE_TELEPHONY}. + * {@link android.content.pm.PackageManager#FEATURE_TELEPHONY}. In cases where only + * partial information is available for a particular CellInfo entry, unavailable fields + * will be reported as Integer.MAX_VALUE. All reported cells will include at least a + * valid set of technology-specific identification info and a power level measurement. * *

* This method is preferred over using {@link