ICU-12676 Add substitute handling enum values to ICU4J.

X-SVN-Rev: 39152

diff --git a/icu4j/main/classes/core/src/com/ibm/icu/text/DisplayContext.java b/icu4j/main/classes/core/src/com/ibm/icu/text/DisplayContext.java
index 78f479ac36b20f3f8c05a030e275facbad5d1a8b..751b4768540a4d9de5060e5f1c6d97bd03214148 100644 (file)
--- a/icu4j/main/classes/core/src/com/ibm/icu/text/DisplayContext.java
+++ b/icu4j/main/classes/core/src/com/ibm/icu/text/DisplayContext.java
@@ -88,7 +88,26 @@ public enum DisplayContext {
      * e.g. "U.S." for US.
      * @stable ICU 54
      */
-    LENGTH_SHORT(Type.DISPLAY_LENGTH, 1);
+    LENGTH_SHORT(Type.DISPLAY_LENGTH, 1),
+    /**
+     * ================================
+     * Settings for SUBSTITUTE_HANDLING (choose one)
+     */
+    /**
+     * A possible setting for SUBSTITUTE_HANDLING:
+     * Returns a fallback value (e.g., the input code) when no data is available.
+     * This is the default behavior.
+     * @draft ICU 58
+     * @provisional This API might change or be removed in a future release.
+     */
+    SUBSTITUTE(Type.SUBSTITUTE_HANDLING, 0),
+    /**
+     * A possible setting for SUBSTITUTE_HANDLING:
+     * Returns a null value when no data is available.
+     * @draft ICU 58
+     * @provisional This API might change or be removed in a future release.
+     */
+    NO_SUBSTITUTE(Type.SUBSTITUTE_HANDLING, 1);
 
     /**
      * Type values for DisplayContext
@@ -110,7 +129,13 @@ public enum DisplayContext {
          * DISPLAY_LENGTH can be set to LENGTH_FULL or LENGTH_SHORT.
          * @stable ICU 54
          */
-        DISPLAY_LENGTH
+        DISPLAY_LENGTH,
+        /**
+         * SUBSTITUTE_HANDLING can be set to SUBSTITUTE or NO_SUBSTITUTE.
+         * @draft ICU 58
+         * @provisional This API might change or be removed in a future release.
+         */
+        SUBSTITUTE_HANDLING
     }
 
     private final Type type;