Imported Upstream version 58.1

[platform/upstream/icu.git] / source / i18n / unicode / ucol.h

diff --git a/source/i18n/unicode/ucol.h b/source/i18n/unicode/ucol.h
index 8b44716..eae88f8 100644 (file)
--- a/source/i18n/unicode/ucol.h
+++ b/source/i18n/unicode/ucol.h
@@ -1,3 +1,5 @@
+// Copyright (C) 2016 and later: Unicode, Inc. and others.
+// License & terms of use: http://www.unicode.org/copyright.html
 /*
 *******************************************************************************
 * Copyright (c) 1996-2015, International Business Machines Corporation and others.
@@ -123,8 +125,13 @@ typedef enum {
   /** upper case sorts before lower case */
   UCOL_UPPER_FIRST = 25,
 
+#ifndef U_HIDE_DEPRECATED_API
+    /**
+     * One more than the highest normal UColAttributeValue value.
+     * @deprecated ICU 58 The numeric value may change over time, see ICU ticket #12420.
+     */
   UCOL_ATTRIBUTE_VALUE_COUNT
-
+#endif  // U_HIDE_DEPRECATED_API
 } UColAttributeValue;
 
 /**
@@ -191,12 +198,13 @@ typedef enum {
     * @stable ICU 4.8
     */    
     UCOL_REORDER_CODE_DIGIT         = 0x1004,
-   /**
-    * The limit of the reorder codes. This is intended for use in range checking 
-    * and enumeration of the reorder codes.
-    * @stable ICU 4.8
-    */    
+#ifndef U_HIDE_DEPRECATED_API
+    /**
+     * One more than the highest normal UColReorderCode value.
+     * @deprecated ICU 58 The numeric value may change over time, see ICU ticket #12420.
+     */
     UCOL_REORDER_CODE_LIMIT         = 0x1005
+#endif  // U_HIDE_DEPRECATED_API
 } UColReorderCode;
 
 /**
@@ -333,10 +341,13 @@ typedef enum {
       * @stable ICU 2.8
       */
      UCOL_NUMERIC_COLLATION = UCOL_STRENGTH + 2, 
-     /**
-      * The number of UColAttribute constants.
-      * @stable ICU 2.0
-      */
+
+    // Do not conditionalize the following with #ifndef U_HIDE_DEPRECATED_API,
+    // it is needed for layout of RuleBasedCollator object.
+    /**
+     * One more than the highest normal UColAttribute value.
+     * @deprecated ICU 58 The numeric value may change over time, see ICU ticket #12420.
+     */
      UCOL_ATTRIBUTE_COUNT
 } UColAttribute;
 
@@ -1050,7 +1061,13 @@ typedef enum {
   UCOL_BOUND_UPPER = 1,
   /** upper bound that will match all the strings that have the same initial substring as the given string */
   UCOL_BOUND_UPPER_LONG = 2,
-  UCOL_BOUND_VALUE_COUNT
+#ifndef U_HIDE_DEPRECATED_API
+    /**
+     * One more than the highest normal UColBoundMode value.
+     * @deprecated ICU 58 The numeric value may change over time, see ICU ticket #12420.
+     */
+    UCOL_BOUND_VALUE_COUNT
+#endif  // U_HIDE_DEPRECATED_API
 } UColBoundMode;
 
 /**