From: Yoshito Umaoka <y.umaoka@gmail.com>
Date: Wed, 18 Sep 2013 20:58:47 +0000 (+0000)
Subject: ICU-10415 Additional fixes to PluralRules and PluralSamples. Incorrect and missing... 
X-Git-Tag: milestone-59-0-1~2483
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=3e7d7e68f80757828ebd48bd880a45323ffb0836;p=icu

ICU-10415 Additional fixes to PluralRules and PluralSamples. Incorrect and missing tags.

X-SVN-Rev: 34386
---

diff --git a/icu4j/main/classes/core/src/com/ibm/icu/text/PluralRules.java b/icu4j/main/classes/core/src/com/ibm/icu/text/PluralRules.java
index 19c0f9cb97e..10e0be04360 100644
--- a/icu4j/main/classes/core/src/com/ibm/icu/text/PluralRules.java
+++ b/icu4j/main/classes/core/src/com/ibm/icu/text/PluralRules.java
@@ -406,13 +406,45 @@ public class PluralRules implements Serializable {
      */
     public static class FixedDecimal extends Number implements Comparable<FixedDecimal> {
         private static final long serialVersionUID = -4756200506571685661L;
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         public final double source;
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         public final int visibleDecimalDigitCount;
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         public final int visibleDecimalDigitCountWithoutTrailingZeros;
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         public final long decimalDigits;
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         public final long decimalDigitsWithoutTrailingZeros;
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         public final long integerValue;
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         public final boolean hasIntegerValue;
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         public final boolean isNegative;
         private final int baseFactor;
 
@@ -686,27 +718,47 @@ public class PluralRules implements Serializable {
             return hasIntegerValue;
         }
 
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         @Override
         public int intValue() {
             // TODO Auto-generated method stub
             return (int)integerValue;
         }
 
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         @Override
         public long longValue() {
             return integerValue;
         }
 
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         @Override
         public float floatValue() {
             return (float) source;
         }
 
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         @Override
         public double doubleValue() {
             return source;
         }
 
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         public long getShiftedValue() {
             return integerValue * baseFactor + decimalDigits;
         }
@@ -736,8 +788,20 @@ public class PluralRules implements Serializable {
      * @deprecated This API is ICU internal only.
      */
     public static class FixedDecimalRange {
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         public final FixedDecimal start;
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         public final FixedDecimal end;
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         public FixedDecimalRange(FixedDecimal start, FixedDecimal end) {
             if (start.visibleDecimalDigitCount != end.visibleDecimalDigitCount) {
                 throw new IllegalArgumentException("Ranges must have the same number of visible decimals: " + start + "~" + end);
@@ -745,6 +809,10 @@ public class PluralRules implements Serializable {
             this.start = start;
             this.end = end;
         }
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         @Override
         public String toString() {
             return start + (end == start ? "" : "~" + end);
@@ -757,8 +825,20 @@ public class PluralRules implements Serializable {
      * @deprecated This API is ICU internal only.
      */
     public static class FixedDecimalSamples {
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         public final SampleType sampleType;
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         public final Set<FixedDecimalRange> samples;
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         public final boolean bounded;
         /**
          * The samples must be immutable.
@@ -771,10 +851,8 @@ public class PluralRules implements Serializable {
             this.samples = samples;
             this.bounded = bounded;
         }
-        /**
+        /*
          * Parse a list of the form described in CLDR. The source must be trimmed.
-         * @param source
-         * @return
          */
         static FixedDecimalSamples parse(String source) {
             SampleType sampleType2;
@@ -826,6 +904,10 @@ public class PluralRules implements Serializable {
             }
         }
 
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         public Set<Double> addSamples(Set<Double> result) {
             for (FixedDecimalRange item : samples) {
                 // we have to convert to longs so we don't get strange double issues
@@ -839,6 +921,10 @@ public class PluralRules implements Serializable {
             return result;
         }
 
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         @Override
         public String toString() {
             StringBuilder b = new StringBuilder("@").append(sampleType.toString().toLowerCase(Locale.ENGLISH));
@@ -857,10 +943,18 @@ public class PluralRules implements Serializable {
             return b.toString();
         }
 
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         public Set<FixedDecimalRange> getSamples() {
             return samples;
         }
 
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         public void getStartEndSamples(Set<FixedDecimal> target) {
             for (FixedDecimalRange item : samples) {
                 target.add(item.start);
@@ -1419,6 +1513,10 @@ public class PluralRules implements Serializable {
                     + (decimalSamples == null ? "" : " " + decimalSamples.toString());
         }
 
+        /**
+         * @internal
+         * @deprecated This API is ICU internal only.
+         */
         @Override
         public int hashCode() {
             return keyword.hashCode() ^ constraint.hashCode();
@@ -1656,6 +1754,10 @@ public class PluralRules implements Serializable {
         this.keywords = Collections.unmodifiableSet(rules.getKeywords());
     }
 
+    /**
+     * @internal
+     * @deprecated This API is ICU internal only.
+     */
     @Override
     public int hashCode() {
         return rules.hashCode();
@@ -1758,7 +1860,9 @@ public class PluralRules implements Serializable {
      * @param keyword the keyword
      * @return the values that trigger this keyword, or null.  The returned collection
      * is immutable. It will be empty if the keyword is not defined.
-     * @stable ICU 4.8
+     * 
+     * @internal
+     * @deprecated This API is ICU internal only.
      */
     public Collection<Double> getAllKeywordValues(String keyword, SampleType type) {
         if (!isLimited(keyword, type)) {
@@ -1831,6 +1935,10 @@ public class PluralRules implements Serializable {
         return result.size() == 0 ? null : Collections.unmodifiableSet(result);
     }
 
+    /**
+     * @internal
+     * @deprecated This API is ICU internal only.
+     */
     public boolean addSample(String keyword, Number sample, int maxCount, Set<Double> result) {
         String selectedKeyword = sample instanceof FixedDecimal ? select((FixedDecimal)sample) : select(sample.doubleValue());
         if (selectedKeyword.equals(keyword)) {
diff --git a/icu4j/main/classes/core/src/com/ibm/icu/text/PluralSamples.java b/icu4j/main/classes/core/src/com/ibm/icu/text/PluralSamples.java
index fc1888dc939..6f1f00f97c1 100644
--- a/icu4j/main/classes/core/src/com/ibm/icu/text/PluralSamples.java
+++ b/icu4j/main/classes/core/src/com/ibm/icu/text/PluralSamples.java
@@ -27,15 +27,27 @@ import com.ibm.icu.util.Output;
 /**
  * @author markdavis
  * Refactor samples as first step to moving into CLDR
+ * 
+ * @internal
+ * @deprecated This API is ICU internal only.
  */
 public class PluralSamples {
 
     private PluralRules pluralRules;
     private final Map<String, List<Double>> _keySamplesMap;
+
+    /**
+     * @internal
+     * @deprecated This API is ICU internal only.
+     */
     public final Map<String, Boolean> _keyLimitedMap;
     private final Map<String, Set<FixedDecimal>> _keyFractionSamplesMap;
     private final Set<FixedDecimal> _fractionSamples;
 
+    /**
+     * @internal
+     * @deprecated This API is ICU internal only.
+     */
     public PluralSamples(PluralRules pluralRules) {
         this.pluralRules = pluralRules;
         Set<String> keywords = pluralRules.getKeywords();
@@ -222,10 +234,7 @@ public class PluralSamples {
         return 37;
     }
 
-    /**
-     * @deprecated This API is ICU internal only.
-     * @internal
-     */
+    @SuppressWarnings("unused")
     private static final Comparator<String> KEYWORD_COMPARATOR = new Comparator<String> () {
         public int compare(String arg0, String arg1) {
             StandardPluralCategories a = StandardPluralCategories.forString(arg0);
@@ -236,6 +245,10 @@ public class PluralSamples {
         }
     };
 
+    /**
+     * @internal
+     * @deprecated This API is ICU internal only.
+     */
     public KeywordStatus getStatus(String keyword, int offset, Set<Double> explicits, Output<Double> uniqueValue) {
         if (uniqueValue != null) {
             uniqueValue.value = null;