From f2c2ae09dac03f5c08e3a04bfab8ee75c1ce8ce9 Mon Sep 17 00:00:00 2001
From: Kirill Grouchnikov <kirillg@google.com>
Date: Tue, 9 Aug 2016 15:07:06 -0400
Subject: [PATCH] Document exceptions thrown by KeyCharacterMap APIs

Bug: 30764621
Change-Id: I40bd0961a30b0e593388930e409249b44a58ec1b
---
 core/java/android/view/KeyCharacterMap.java | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/core/java/android/view/KeyCharacterMap.java b/core/java/android/view/KeyCharacterMap.java
index 55dd6bb64fe65..c8b89e7ac6079 100644
--- a/core/java/android/view/KeyCharacterMap.java
+++ b/core/java/android/view/KeyCharacterMap.java
@@ -439,6 +439,7 @@ public class KeyCharacterMap implements Parcelable {
      * @param keyCode The keycode.
      * @param chars The array of matching characters to consider.
      * @return The matching associated character, or 0 if none.
+     * @throws {@link IllegalArgumentException} if the passed array of characters is null.
      */
     public char getMatch(int keyCode, char[] chars) {
         return getMatch(keyCode, chars, 0);
@@ -453,6 +454,7 @@ public class KeyCharacterMap implements Parcelable {
      * @param chars The array of matching characters to consider.
      * @param metaState The preferred meta key modifier state.
      * @return The matching associated character, or 0 if none.
+     * @throws {@link IllegalArgumentException} if the passed array of characters is null.
      */
     public char getMatch(int keyCode, char[] chars, int metaState) {
         if (chars == null) {
@@ -599,6 +601,7 @@ public class KeyCharacterMap implements Parcelable {
      * @param chars The sequence of characters to generate.
      * @return An array of {@link KeyEvent} objects, or null if the given char array
      *         can not be generated using the current key character map.
+     * @throws {@link IllegalArgumentException} if the passed array of characters is null.
      */
     public KeyEvent[] getEvents(char[] chars) {
         if (chars == null) {