ICU-9995 Remove Region.UNDEFINED_NUMERIC_CODE and document.

X-SVN-Rev: 34333

diff --git a/icu4j/main/classes/core/src/com/ibm/icu/util/Region.java b/icu4j/main/classes/core/src/com/ibm/icu/util/Region.java
index a761782e2fffbd3a9826f8e796b101e816c76a13..4943052e6f46eeff97ffe926d9ebefcad0b8d22b 100644 (file)
--- a/icu4j/main/classes/core/src/com/ibm/icu/util/Region.java
+++ b/icu4j/main/classes/core/src/com/ibm/icu/util/Region.java
@@ -115,14 +115,6 @@ public class Region implements Comparable<Region> {
         DEPRECATED,
     }
 
-    /**
-     * A constant used for unknown numeric region code.
-     * @see #getNumericCode()
-     * @draft ICU 50
-     * @provisional This API might change or be removed in a future release.
-     */
-    public static final int UNDEFINED_NUMERIC_CODE = -1;
-
     private String id;
     private int code;
     private RegionType type;
@@ -207,7 +199,7 @@ public class Region implements Comparable<Region> {
                 numericCodeMap.put(r.code, r);
                 r.type = RegionType.SUBCONTINENT;
             } else {
-                r.code = UNDEFINED_NUMERIC_CODE;
+                r.code = -1;
             }
             regions.add(r);
         }
@@ -233,7 +225,7 @@ public class Region implements Comparable<Region> {
                         r.code = Integer.valueOf(aliasFrom).intValue();
                         numericCodeMap.put(r.code, r);
                     } else {
-                        r.code = UNDEFINED_NUMERIC_CODE;
+                        r.code = -1;
                     }
                     regions.add(r);
                 }
@@ -563,12 +555,12 @@ public class Region implements Comparable<Region> {
         return id;
     }
 
-    /** Returns the numeric code for this region
+    /**
+     * Returns the numeric code for this region
+     * 
+     * @return The numeric code for this region. Returns a negative value if the given region does not have a numeric
+     *         code assigned to it. This is a very rare case and only occurs for a few very small territories.
      * 
-     * @return The numeric code for this region.   Returns UNDEFINED_NUMERIC_CODE (-1) if the
-     * given region does not have a numeric code assigned to it.  This is a very rare case and
-     * only occurs for a few very small territories.
-     *
      * @draft ICU 50
      * @provisional This API might change or be removed in a future release.
      */