ICU-66108.tar.gz

[apple/icu.git] / icuSources / i18n / unicode / numberrangeformatter.h

diff --git a/icuSources/i18n/unicode/numberrangeformatter.h b/icuSources/i18n/unicode/numberrangeformatter.h
index 35b95d88af5e4c952af1c982c0ee7bdd6f72652a..0f0d2af5f5b2af960ff218d3204fef27eaf60ffb 100644 (file)
--- a/icuSources/i18n/unicode/numberrangeformatter.h
+++ b/icuSources/i18n/unicode/numberrangeformatter.h
@@ -1,10 +1,15 @@
 // © 2018 and later: Unicode, Inc. and others.
 // License & terms of use: http://www.unicode.org/copyright.html
 
 // © 2018 and later: Unicode, Inc. and others.
 // License & terms of use: http://www.unicode.org/copyright.html
 

-#if !UCONFIG_NO_FORMATTING

 #ifndef __NUMBERRANGEFORMATTER_H__
 #define __NUMBERRANGEFORMATTER_H__
 
 #ifndef __NUMBERRANGEFORMATTER_H__
 #define __NUMBERRANGEFORMATTER_H__
 

+#include "unicode/utypes.h"
+
+#if U_SHOW_CPLUSPLUS_API
+
+#if !UCONFIG_NO_FORMATTING
+

 #include <atomic>
 #include "unicode/appendable.h"
 #include "unicode/fieldpos.h"
 #include <atomic>
 #include "unicode/appendable.h"
 #include "unicode/fieldpos.h"


@@ -12,8 +17,6 @@
 #include "unicode/fpositer.h"
 #include "unicode/numberformatter.h"
 
 #include "unicode/fpositer.h"
 #include "unicode/numberformatter.h"
 

-#ifndef U_HIDE_DRAFT_API
-

 /**
  * \file
  * \brief C++ API: Library for localized formatting of number, currency, and unit ranges.
 /**
  * \file
  * \brief C++ API: Library for localized formatting of number, currency, and unit ranges.


@@ -44,7 +47,7 @@
 /**
  * Defines how to merge fields that are identical across the range sign.
  *
 /**
  * Defines how to merge fields that are identical across the range sign.
  *

- * @draft ICU 63
+ * @stable ICU 63

  */
 typedef enum UNumberRangeCollapse {
     /**
  */
 typedef enum UNumberRangeCollapse {
     /**


@@ -53,14 +56,14 @@ typedef enum UNumberRangeCollapse {
      *
      * The heuristics used for this option are subject to change over time.
      *
      *
      * The heuristics used for this option are subject to change over time.
      *

-     * @draft ICU 63
+     * @stable ICU 63

      */
     UNUM_RANGE_COLLAPSE_AUTO,
 
     /**
      * Do not collapse any part of the number. Example: "3.2 thousand kilograms – 5.3 thousand kilograms"
      *
      */
     UNUM_RANGE_COLLAPSE_AUTO,
 
     /**
      * Do not collapse any part of the number. Example: "3.2 thousand kilograms – 5.3 thousand kilograms"
      *

-     * @draft ICU 63
+     * @stable ICU 63

      */
     UNUM_RANGE_COLLAPSE_NONE,
 
      */
     UNUM_RANGE_COLLAPSE_NONE,
 


@@ -68,7 +71,7 @@ typedef enum UNumberRangeCollapse {
      * Collapse the unit part of the number, but not the notation, if present. Example: "3.2 thousand – 5.3 thousand
      * kilograms"
      *
      * Collapse the unit part of the number, but not the notation, if present. Example: "3.2 thousand – 5.3 thousand
      * kilograms"
      *

-     * @draft ICU 63
+     * @stable ICU 63

      */
     UNUM_RANGE_COLLAPSE_UNIT,
 
      */
     UNUM_RANGE_COLLAPSE_UNIT,
 


@@ -76,7 +79,7 @@ typedef enum UNumberRangeCollapse {
      * Collapse any field that is equal across the range sign. May introduce ambiguity on the magnitude of the
      * number. Example: "3.2 – 5.3 thousand kilograms"
      *
      * Collapse any field that is equal across the range sign. May introduce ambiguity on the magnitude of the
      * number. Example: "3.2 – 5.3 thousand kilograms"
      *

-     * @draft ICU 63
+     * @stable ICU 63

      */
     UNUM_RANGE_COLLAPSE_ALL
 } UNumberRangeCollapse;
      */
     UNUM_RANGE_COLLAPSE_ALL
 } UNumberRangeCollapse;


@@ -85,14 +88,14 @@ typedef enum UNumberRangeCollapse {
  * Defines the behavior when the two numbers in the range are identical after rounding. To programmatically detect
  * when the identity fallback is used, compare the lower and upper BigDecimals via FormattedNumber.
  *
  * Defines the behavior when the two numbers in the range are identical after rounding. To programmatically detect
  * when the identity fallback is used, compare the lower and upper BigDecimals via FormattedNumber.
  *

- * @draft ICU 63
+ * @stable ICU 63

  * @see NumberRangeFormatter
  */
 typedef enum UNumberRangeIdentityFallback {
     /**
      * Show the number as a single value rather than a range. Example: "$5"
      *
  * @see NumberRangeFormatter
  */
 typedef enum UNumberRangeIdentityFallback {
     /**
      * Show the number as a single value rather than a range. Example: "$5"
      *

-     * @draft ICU 63
+     * @stable ICU 63

      */
     UNUM_IDENTITY_FALLBACK_SINGLE_VALUE,
 
      */
     UNUM_IDENTITY_FALLBACK_SINGLE_VALUE,
 


@@ -100,7 +103,7 @@ typedef enum UNumberRangeIdentityFallback {
      * Show the number using a locale-sensitive approximation pattern. If the numbers were the same before rounding,
      * show the single value. Example: "~$5" or "$5"
      *
      * Show the number using a locale-sensitive approximation pattern. If the numbers were the same before rounding,
      * show the single value. Example: "~$5" or "$5"
      *

-     * @draft ICU 63
+     * @stable ICU 63

      */
     UNUM_IDENTITY_FALLBACK_APPROXIMATELY_OR_SINGLE_VALUE,
 
      */
     UNUM_IDENTITY_FALLBACK_APPROXIMATELY_OR_SINGLE_VALUE,
 


@@ -108,7 +111,7 @@ typedef enum UNumberRangeIdentityFallback {
      * Show the number using a locale-sensitive approximation pattern. Use the range pattern always, even if the
      * inputs are the same. Example: "~$5"
      *
      * Show the number using a locale-sensitive approximation pattern. Use the range pattern always, even if the
      * inputs are the same. Example: "~$5"
      *

-     * @draft ICU 63
+     * @stable ICU 63

      */
     UNUM_IDENTITY_FALLBACK_APPROXIMATELY,
 
      */
     UNUM_IDENTITY_FALLBACK_APPROXIMATELY,
 


@@ -116,7 +119,7 @@ typedef enum UNumberRangeIdentityFallback {
      * Show the number as the range of two equal values. Use the range pattern always, even if the inputs are the
      * same. Example (with RangeCollapse.NONE): "$5 – $5"
      *
      * Show the number as the range of two equal values. Use the range pattern always, even if the inputs are the
      * same. Example (with RangeCollapse.NONE): "$5 – $5"
      *

-     * @draft ICU 63
+     * @stable ICU 63

      */
     UNUM_IDENTITY_FALLBACK_RANGE
 } UNumberRangeIdentityFallback;
      */
     UNUM_IDENTITY_FALLBACK_RANGE
 } UNumberRangeIdentityFallback;


@@ -125,14 +128,14 @@ typedef enum UNumberRangeIdentityFallback {
  * Used in the result class FormattedNumberRange to indicate to the user whether the numbers formatted in the range
  * were equal or not, and whether or not the identity fallback was applied.
  *
  * Used in the result class FormattedNumberRange to indicate to the user whether the numbers formatted in the range
  * were equal or not, and whether or not the identity fallback was applied.
  *

- * @draft ICU 63
+ * @stable ICU 63

  * @see NumberRangeFormatter
  */
 typedef enum UNumberRangeIdentityResult {
     /**
      * Used to indicate that the two numbers in the range were equal, even before any rounding rules were applied.
      *
  * @see NumberRangeFormatter
  */
 typedef enum UNumberRangeIdentityResult {
     /**
      * Used to indicate that the two numbers in the range were equal, even before any rounding rules were applied.
      *

-     * @draft ICU 63
+     * @stable ICU 63

      * @see NumberRangeFormatter
      */
     UNUM_IDENTITY_RESULT_EQUAL_BEFORE_ROUNDING,
      * @see NumberRangeFormatter
      */
     UNUM_IDENTITY_RESULT_EQUAL_BEFORE_ROUNDING,


@@ -140,7 +143,7 @@ typedef enum UNumberRangeIdentityResult {
     /**
      * Used to indicate that the two numbers in the range were equal, but only after rounding rules were applied.
      *
     /**
      * Used to indicate that the two numbers in the range were equal, but only after rounding rules were applied.
      *

-     * @draft ICU 63
+     * @stable ICU 63

      * @see NumberRangeFormatter
      */
     UNUM_IDENTITY_RESULT_EQUAL_AFTER_ROUNDING,
      * @see NumberRangeFormatter
      */
     UNUM_IDENTITY_RESULT_EQUAL_AFTER_ROUNDING,


@@ -148,7 +151,7 @@ typedef enum UNumberRangeIdentityResult {
     /**
      * Used to indicate that the two numbers in the range were not equal, even after rounding rules were applied.
      *
     /**
      * Used to indicate that the two numbers in the range were not equal, even after rounding rules were applied.
      *

-     * @draft ICU 63
+     * @stable ICU 63

      * @see NumberRangeFormatter
      */
     UNUM_IDENTITY_RESULT_NOT_EQUAL,
      * @see NumberRangeFormatter
      */
     UNUM_IDENTITY_RESULT_NOT_EQUAL,


@@ -163,7 +166,6 @@ typedef enum UNumberRangeIdentityResult {
 
 } UNumberRangeIdentityResult;
 
 
 } UNumberRangeIdentityResult;
 

-#if U_SHOW_CPLUSPLUS_API

 U_NAMESPACE_BEGIN
 
 namespace number {  // icu::number
 U_NAMESPACE_BEGIN
 
 namespace number {  // icu::number


@@ -255,7 +257,7 @@ class U_I18N_API NumberRangeFormatterSettings {
      * @param formatter
      *            The formatter to use for both numbers in the range.
      * @return The fluent chain.
      * @param formatter
      *            The formatter to use for both numbers in the range.
      * @return The fluent chain.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     Derived numberFormatterBoth(const UnlocalizedNumberFormatter &formatter) const &;
 
      */
     Derived numberFormatterBoth(const UnlocalizedNumberFormatter &formatter) const &;
 


@@ -266,7 +268,7 @@ class U_I18N_API NumberRangeFormatterSettings {
      *            The formatter to use for both numbers in the range.
      * @return The fluent chain.
      * @see #numberFormatterBoth
      *            The formatter to use for both numbers in the range.
      * @return The fluent chain.
      * @see #numberFormatterBoth

-     * @draft ICU 63
+     * @stable ICU 63

      */
     Derived numberFormatterBoth(const UnlocalizedNumberFormatter &formatter) &&;
 
      */
     Derived numberFormatterBoth(const UnlocalizedNumberFormatter &formatter) &&;
 


@@ -277,7 +279,7 @@ class U_I18N_API NumberRangeFormatterSettings {
      *            The formatter to use for both numbers in the range.
      * @return The fluent chain.
      * @see #numberFormatterBoth
      *            The formatter to use for both numbers in the range.
      * @return The fluent chain.
      * @see #numberFormatterBoth

-     * @draft ICU 63
+     * @stable ICU 63

      */
     Derived numberFormatterBoth(UnlocalizedNumberFormatter &&formatter) const &;
 
      */
     Derived numberFormatterBoth(UnlocalizedNumberFormatter &&formatter) const &;
 


@@ -288,7 +290,7 @@ class U_I18N_API NumberRangeFormatterSettings {
      *            The formatter to use for both numbers in the range.
      * @return The fluent chain.
      * @see #numberFormatterBoth
      *            The formatter to use for both numbers in the range.
      * @return The fluent chain.
      * @see #numberFormatterBoth

-     * @draft ICU 63
+     * @stable ICU 63

      */
     Derived numberFormatterBoth(UnlocalizedNumberFormatter &&formatter) &&;
 
      */
     Derived numberFormatterBoth(UnlocalizedNumberFormatter &&formatter) &&;
 


@@ -301,7 +303,7 @@ class U_I18N_API NumberRangeFormatterSettings {
      * @param formatterFirst
      *            The formatter to use for the first number in the range.
      * @return The fluent chain.
      * @param formatterFirst
      *            The formatter to use for the first number in the range.
      * @return The fluent chain.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     Derived numberFormatterFirst(const UnlocalizedNumberFormatter &formatterFirst) const &;
 
      */
     Derived numberFormatterFirst(const UnlocalizedNumberFormatter &formatterFirst) const &;
 


@@ -312,7 +314,7 @@ class U_I18N_API NumberRangeFormatterSettings {
      *            The formatter to use for the first number in the range.
      * @return The fluent chain.
      * @see #numberFormatterFirst
      *            The formatter to use for the first number in the range.
      * @return The fluent chain.
      * @see #numberFormatterFirst

-     * @draft ICU 63
+     * @stable ICU 63

      */
     Derived numberFormatterFirst(const UnlocalizedNumberFormatter &formatterFirst) &&;
 
      */
     Derived numberFormatterFirst(const UnlocalizedNumberFormatter &formatterFirst) &&;
 


@@ -323,7 +325,7 @@ class U_I18N_API NumberRangeFormatterSettings {
      *            The formatter to use for the first number in the range.
      * @return The fluent chain.
      * @see #numberFormatterFirst
      *            The formatter to use for the first number in the range.
      * @return The fluent chain.
      * @see #numberFormatterFirst

-     * @draft ICU 63
+     * @stable ICU 63

      */
     Derived numberFormatterFirst(UnlocalizedNumberFormatter &&formatterFirst) const &;
 
      */
     Derived numberFormatterFirst(UnlocalizedNumberFormatter &&formatterFirst) const &;
 


@@ -334,7 +336,7 @@ class U_I18N_API NumberRangeFormatterSettings {
      *            The formatter to use for the first number in the range.
      * @return The fluent chain.
      * @see #numberFormatterFirst
      *            The formatter to use for the first number in the range.
      * @return The fluent chain.
      * @see #numberFormatterFirst

-     * @draft ICU 63
+     * @stable ICU 63

      */
     Derived numberFormatterFirst(UnlocalizedNumberFormatter &&formatterFirst) &&;
 
      */
     Derived numberFormatterFirst(UnlocalizedNumberFormatter &&formatterFirst) &&;
 


@@ -347,7 +349,7 @@ class U_I18N_API NumberRangeFormatterSettings {
      * @param formatterSecond
      *            The formatter to use for the second number in the range.
      * @return The fluent chain.
      * @param formatterSecond
      *            The formatter to use for the second number in the range.
      * @return The fluent chain.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     Derived numberFormatterSecond(const UnlocalizedNumberFormatter &formatterSecond) const &;
 
      */
     Derived numberFormatterSecond(const UnlocalizedNumberFormatter &formatterSecond) const &;
 


@@ -358,7 +360,7 @@ class U_I18N_API NumberRangeFormatterSettings {
      *            The formatter to use for the second number in the range.
      * @return The fluent chain.
      * @see #numberFormatterSecond
      *            The formatter to use for the second number in the range.
      * @return The fluent chain.
      * @see #numberFormatterSecond

-     * @draft ICU 63
+     * @stable ICU 63

      */
     Derived numberFormatterSecond(const UnlocalizedNumberFormatter &formatterSecond) &&;
 
      */
     Derived numberFormatterSecond(const UnlocalizedNumberFormatter &formatterSecond) &&;
 


@@ -369,7 +371,7 @@ class U_I18N_API NumberRangeFormatterSettings {
      *            The formatter to use for the second number in the range.
      * @return The fluent chain.
      * @see #numberFormatterSecond
      *            The formatter to use for the second number in the range.
      * @return The fluent chain.
      * @see #numberFormatterSecond

-     * @draft ICU 63
+     * @stable ICU 63

      */
     Derived numberFormatterSecond(UnlocalizedNumberFormatter &&formatterSecond) const &;
 
      */
     Derived numberFormatterSecond(UnlocalizedNumberFormatter &&formatterSecond) const &;
 


@@ -380,7 +382,7 @@ class U_I18N_API NumberRangeFormatterSettings {
      *            The formatter to use for the second number in the range.
      * @return The fluent chain.
      * @see #numberFormatterSecond
      *            The formatter to use for the second number in the range.
      * @return The fluent chain.
      * @see #numberFormatterSecond

-     * @draft ICU 63
+     * @stable ICU 63

      */
     Derived numberFormatterSecond(UnlocalizedNumberFormatter &&formatterSecond) &&;
 
      */
     Derived numberFormatterSecond(UnlocalizedNumberFormatter &&formatterSecond) &&;
 


@@ -399,7 +401,7 @@ class U_I18N_API NumberRangeFormatterSettings {
      * @param collapse
      *            The collapsing strategy to use for this range.
      * @return The fluent chain.
      * @param collapse
      *            The collapsing strategy to use for this range.
      * @return The fluent chain.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     Derived collapse(UNumberRangeCollapse collapse) const &;
 
      */
     Derived collapse(UNumberRangeCollapse collapse) const &;
 


@@ -410,7 +412,7 @@ class U_I18N_API NumberRangeFormatterSettings {
      *            The collapsing strategy to use for this range.
      * @return The fluent chain.
      * @see #collapse
      *            The collapsing strategy to use for this range.
      * @return The fluent chain.
      * @see #collapse

-     * @draft ICU 63
+     * @stable ICU 63

      */
     Derived collapse(UNumberRangeCollapse collapse) &&;
 
      */
     Derived collapse(UNumberRangeCollapse collapse) &&;
 


@@ -432,7 +434,7 @@ class U_I18N_API NumberRangeFormatterSettings {
      * @param identityFallback
      *            The strategy to use when formatting two numbers that end up being the same.
      * @return The fluent chain.
      * @param identityFallback
      *            The strategy to use when formatting two numbers that end up being the same.
      * @return The fluent chain.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     Derived identityFallback(UNumberRangeIdentityFallback identityFallback) const &;
 
      */
     Derived identityFallback(UNumberRangeIdentityFallback identityFallback) const &;
 


@@ -443,10 +445,11 @@ class U_I18N_API NumberRangeFormatterSettings {
      *            The strategy to use when formatting two numbers that end up being the same.
      * @return The fluent chain.
      * @see #identityFallback
      *            The strategy to use when formatting two numbers that end up being the same.
      * @return The fluent chain.
      * @see #identityFallback

-     * @draft ICU 63
+     * @stable ICU 63

      */
     Derived identityFallback(UNumberRangeIdentityFallback identityFallback) &&;
 
      */
     Derived identityFallback(UNumberRangeIdentityFallback identityFallback) &&;
 

+#ifndef U_HIDE_DRAFT_API

     /**
      * Returns the current (Un)LocalizedNumberRangeFormatter as a LocalPointer
      * wrapping a heap-allocated copy of the current object.
     /**
      * Returns the current (Un)LocalizedNumberRangeFormatter as a LocalPointer
      * wrapping a heap-allocated copy of the current object.


@@ -468,12 +471,13 @@ class U_I18N_API NumberRangeFormatterSettings {
      * @draft ICU 64
      */
     LocalPointer<Derived> clone() &&;
      * @draft ICU 64
      */
     LocalPointer<Derived> clone() &&;

+#endif  /* U_HIDE_DRAFT_API */

 
     /**
      * Sets the UErrorCode if an error occurred in the fluent chain.
      * Preserves older error codes in the outErrorCode.
      * @return TRUE if U_FAILURE(outErrorCode)
 
     /**
      * Sets the UErrorCode if an error occurred in the fluent chain.
      * Preserves older error codes in the outErrorCode.
      * @return TRUE if U_FAILURE(outErrorCode)

-     * @draft ICU 63
+     * @stable ICU 63

      */
     UBool copyErrorTo(UErrorCode &outErrorCode) const {
         if (U_FAILURE(outErrorCode)) {
      */
     UBool copyErrorTo(UErrorCode &outErrorCode) const {
         if (U_FAILURE(outErrorCode)) {


@@ -502,7 +506,7 @@ class U_I18N_API NumberRangeFormatterSettings {
  * Instances of this class are immutable and thread-safe.
  *
  * @see NumberRangeFormatter
  * Instances of this class are immutable and thread-safe.
  *
  * @see NumberRangeFormatter

- * @draft ICU 63
+ * @stable ICU 63

  */
 class U_I18N_API UnlocalizedNumberRangeFormatter
         : public NumberRangeFormatterSettings<UnlocalizedNumberRangeFormatter>, public UMemory {
  */
 class U_I18N_API UnlocalizedNumberRangeFormatter
         : public NumberRangeFormatterSettings<UnlocalizedNumberRangeFormatter>, public UMemory {


@@ -515,7 +519,7 @@ class U_I18N_API UnlocalizedNumberRangeFormatter
      * @param locale
      *            The locale to use when loading data for number formatting.
      * @return The fluent chain.
      * @param locale
      *            The locale to use when loading data for number formatting.
      * @return The fluent chain.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     LocalizedNumberRangeFormatter locale(const icu::Locale &locale) const &;
 
      */
     LocalizedNumberRangeFormatter locale(const icu::Locale &locale) const &;
 


@@ -526,40 +530,40 @@ class U_I18N_API UnlocalizedNumberRangeFormatter
      *            The locale to use when loading data for number formatting.
      * @return The fluent chain.
      * @see #locale
      *            The locale to use when loading data for number formatting.
      * @return The fluent chain.
      * @see #locale

-     * @draft ICU 63
+     * @stable ICU 63

      */
     LocalizedNumberRangeFormatter locale(const icu::Locale &locale) &&;
 
     /**
      * Default constructor: puts the formatter into a valid but undefined state.
      *
      */
     LocalizedNumberRangeFormatter locale(const icu::Locale &locale) &&;
 
     /**
      * Default constructor: puts the formatter into a valid but undefined state.
      *

-     * @draft ICU 63
+     * @stable ICU 63

      */
     UnlocalizedNumberRangeFormatter() = default;
 
     /**
      * Returns a copy of this UnlocalizedNumberRangeFormatter.
      */
     UnlocalizedNumberRangeFormatter() = default;
 
     /**
      * Returns a copy of this UnlocalizedNumberRangeFormatter.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     UnlocalizedNumberRangeFormatter(const UnlocalizedNumberRangeFormatter &other);
 
     /**
      * Move constructor:
      * The source UnlocalizedNumberRangeFormatter will be left in a valid but undefined state.
      */
     UnlocalizedNumberRangeFormatter(const UnlocalizedNumberRangeFormatter &other);
 
     /**
      * Move constructor:
      * The source UnlocalizedNumberRangeFormatter will be left in a valid but undefined state.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     UnlocalizedNumberRangeFormatter(UnlocalizedNumberRangeFormatter&& src) U_NOEXCEPT;
 
     /**
      * Copy assignment operator.
      */
     UnlocalizedNumberRangeFormatter(UnlocalizedNumberRangeFormatter&& src) U_NOEXCEPT;
 
     /**
      * Copy assignment operator.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     UnlocalizedNumberRangeFormatter& operator=(const UnlocalizedNumberRangeFormatter& other);
 
     /**
      * Move assignment operator:
      * The source UnlocalizedNumberRangeFormatter will be left in a valid but undefined state.
      */
     UnlocalizedNumberRangeFormatter& operator=(const UnlocalizedNumberRangeFormatter& other);
 
     /**
      * Move assignment operator:
      * The source UnlocalizedNumberRangeFormatter will be left in a valid but undefined state.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     UnlocalizedNumberRangeFormatter& operator=(UnlocalizedNumberRangeFormatter&& src) U_NOEXCEPT;
 
      */
     UnlocalizedNumberRangeFormatter& operator=(UnlocalizedNumberRangeFormatter&& src) U_NOEXCEPT;
 


@@ -583,7 +587,7 @@ class U_I18N_API UnlocalizedNumberRangeFormatter
  * Instances of this class are immutable and thread-safe.
  *
  * @see NumberFormatter
  * Instances of this class are immutable and thread-safe.
  *
  * @see NumberFormatter

- * @draft ICU 63
+ * @stable ICU 63

  */
 class U_I18N_API LocalizedNumberRangeFormatter
         : public NumberRangeFormatterSettings<LocalizedNumberRangeFormatter>, public UMemory {
  */
 class U_I18N_API LocalizedNumberRangeFormatter
         : public NumberRangeFormatterSettings<LocalizedNumberRangeFormatter>, public UMemory {


@@ -599,7 +603,7 @@ class U_I18N_API LocalizedNumberRangeFormatter
      * @param status
      *            Set if an error occurs while formatting.
      * @return A FormattedNumberRange object; call .toString() to get the string.
      * @param status
      *            Set if an error occurs while formatting.
      * @return A FormattedNumberRange object; call .toString() to get the string.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     FormattedNumberRange formatFormattableRange(
         const Formattable& first, const Formattable& second, UErrorCode& status) const;
      */
     FormattedNumberRange formatFormattableRange(
         const Formattable& first, const Formattable& second, UErrorCode& status) const;


@@ -607,33 +611,33 @@ class U_I18N_API LocalizedNumberRangeFormatter
     /**
      * Default constructor: puts the formatter into a valid but undefined state.
      *
     /**
      * Default constructor: puts the formatter into a valid but undefined state.
      *

-     * @draft ICU 63
+     * @stable ICU 63

      */
     LocalizedNumberRangeFormatter() = default;
 
     /**
      * Returns a copy of this LocalizedNumberRangeFormatter.
      */
     LocalizedNumberRangeFormatter() = default;
 
     /**
      * Returns a copy of this LocalizedNumberRangeFormatter.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     LocalizedNumberRangeFormatter(const LocalizedNumberRangeFormatter &other);
 
     /**
      * Move constructor:
      * The source LocalizedNumberRangeFormatter will be left in a valid but undefined state.
      */
     LocalizedNumberRangeFormatter(const LocalizedNumberRangeFormatter &other);
 
     /**
      * Move constructor:
      * The source LocalizedNumberRangeFormatter will be left in a valid but undefined state.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     LocalizedNumberRangeFormatter(LocalizedNumberRangeFormatter&& src) U_NOEXCEPT;
 
     /**
      * Copy assignment operator.
      */
     LocalizedNumberRangeFormatter(LocalizedNumberRangeFormatter&& src) U_NOEXCEPT;
 
     /**
      * Copy assignment operator.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     LocalizedNumberRangeFormatter& operator=(const LocalizedNumberRangeFormatter& other);
 
     /**
      * Move assignment operator:
      * The source LocalizedNumberRangeFormatter will be left in a valid but undefined state.
      */
     LocalizedNumberRangeFormatter& operator=(const LocalizedNumberRangeFormatter& other);
 
     /**
      * Move assignment operator:
      * The source LocalizedNumberRangeFormatter will be left in a valid but undefined state.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     LocalizedNumberRangeFormatter& operator=(LocalizedNumberRangeFormatter&& src) U_NOEXCEPT;
 
      */
     LocalizedNumberRangeFormatter& operator=(LocalizedNumberRangeFormatter&& src) U_NOEXCEPT;
 


@@ -652,11 +656,11 @@ class U_I18N_API LocalizedNumberRangeFormatter
     void formatImpl(impl::UFormattedNumberRangeData& results, bool equalBeforeRounding,
                     UErrorCode& status) const;
 
     void formatImpl(impl::UFormattedNumberRangeData& results, bool equalBeforeRounding,
                     UErrorCode& status) const;
 

-#endif
+#endif  /* U_HIDE_INTERNAL_API */

 
     /**
      * Destruct this LocalizedNumberRangeFormatter, cleaning up any memory it might own.
 
     /**
      * Destruct this LocalizedNumberRangeFormatter, cleaning up any memory it might own.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     ~LocalizedNumberRangeFormatter();
 
      */
     ~LocalizedNumberRangeFormatter();
 


@@ -691,7 +695,7 @@ class U_I18N_API LocalizedNumberRangeFormatter
  *
  * Instances of this class are immutable and thread-safe.
  *
  *
  * Instances of this class are immutable and thread-safe.
  *

- * @draft ICU 63
+ * @stable ICU 63

  */
 class U_I18N_API FormattedNumberRange : public UMemory, public FormattedValue {
   public:
  */
 class U_I18N_API FormattedNumberRange : public UMemory, public FormattedValue {
   public:


@@ -701,7 +705,7 @@ class U_I18N_API FormattedNumberRange : public UMemory, public FormattedValue {
      *
      * For more information, see FormattedValue::toString()
      *
      *
      * For more information, see FormattedValue::toString()
      *

-     * @draft ICU 63
+     * @stable ICU 63

      */
     UnicodeString toString(UErrorCode& status) const U_OVERRIDE;
 
      */
     UnicodeString toString(UErrorCode& status) const U_OVERRIDE;
 


@@ -715,7 +719,7 @@ class U_I18N_API FormattedNumberRange : public UMemory, public FormattedValue {
      *
      * For more information, see FormattedValue::appendTo()
      *
      *
      * For more information, see FormattedValue::appendTo()
      *

-     * @draft ICU 63
+     * @stable ICU 63

      */
     Appendable &appendTo(Appendable &appendable, UErrorCode& status) const U_OVERRIDE;
 
      */
     Appendable &appendTo(Appendable &appendable, UErrorCode& status) const U_OVERRIDE;
 


@@ -723,6 +727,7 @@ class U_I18N_API FormattedNumberRange : public UMemory, public FormattedValue {
     /** @copydoc FormattedValue::nextPosition() */
     UBool nextPosition(ConstrainedFieldPosition& cfpos, UErrorCode& status) const U_OVERRIDE;
 
     /** @copydoc FormattedValue::nextPosition() */
     UBool nextPosition(ConstrainedFieldPosition& cfpos, UErrorCode& status) const U_OVERRIDE;
 

+#ifndef U_HIDE_DRAFT_API

     /**
      * Determines the start (inclusive) and end (exclusive) indices of the next occurrence of the given
      * <em>field</em> in the output string. This allows you to determine the locations of, for example,
     /**
      * Determines the start (inclusive) and end (exclusive) indices of the next occurrence of the given
      * <em>field</em> in the output string. This allows you to determine the locations of, for example,


@@ -800,6 +805,7 @@ class U_I18N_API FormattedNumberRange : public UMemory, public FormattedValue {
      * @see #getFirstDecimal
      */
     UnicodeString getSecondDecimal(UErrorCode& status) const;
      * @see #getFirstDecimal
      */
     UnicodeString getSecondDecimal(UErrorCode& status) const;

+#endif // U_HIDE_DRAFT_API

 
     /**
      * Returns whether the pair of numbers was successfully formatted as a range or whether an identity fallback was
 
     /**
      * Returns whether the pair of numbers was successfully formatted as a range or whether an identity fallback was


@@ -807,7 +813,7 @@ class U_I18N_API FormattedNumberRange : public UMemory, public FormattedValue {
      * identity fallback was used.
      *
      * @return An indication the resulting identity situation in the formatted number range.
      * identity fallback was used.
      *
      * @return An indication the resulting identity situation in the formatted number range.

-     * @draft ICU 63
+     * @stable ICU 63

      * @see UNumberRangeIdentityFallback
      */
     UNumberRangeIdentityResult getIdentityResult(UErrorCode& status) const;
      * @see UNumberRangeIdentityFallback
      */
     UNumberRangeIdentityResult getIdentityResult(UErrorCode& status) const;


@@ -825,20 +831,20 @@ class U_I18N_API FormattedNumberRange : public UMemory, public FormattedValue {
     /**
      * Move constructor:
      * Leaves the source FormattedNumberRange in an undefined state.
     /**
      * Move constructor:
      * Leaves the source FormattedNumberRange in an undefined state.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     FormattedNumberRange(FormattedNumberRange&& src) U_NOEXCEPT;
 
     /**
      * Move assignment:
      * Leaves the source FormattedNumberRange in an undefined state.
      */
     FormattedNumberRange(FormattedNumberRange&& src) U_NOEXCEPT;
 
     /**
      * Move assignment:
      * Leaves the source FormattedNumberRange in an undefined state.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     FormattedNumberRange& operator=(FormattedNumberRange&& src) U_NOEXCEPT;
 
     /**
      * Destruct an instance of FormattedNumberRange, cleaning up any memory it might own.
      */
     FormattedNumberRange& operator=(FormattedNumberRange&& src) U_NOEXCEPT;
 
     /**
      * Destruct an instance of FormattedNumberRange, cleaning up any memory it might own.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     ~FormattedNumberRange();
 
      */
     ~FormattedNumberRange();
 


@@ -851,7 +857,6 @@ class U_I18N_API FormattedNumberRange : public UMemory, public FormattedValue {
 
     /**
      * Internal constructor from data type. Adopts the data pointer.
 
     /**
      * Internal constructor from data type. Adopts the data pointer.

-     * @internal

      */
     explicit FormattedNumberRange(impl::UFormattedNumberRangeData *results)
         : fData(results), fErrorCode(U_ZERO_ERROR) {}
      */
     explicit FormattedNumberRange(impl::UFormattedNumberRangeData *results)
         : fData(results), fErrorCode(U_ZERO_ERROR) {}


@@ -868,7 +873,7 @@ class U_I18N_API FormattedNumberRange : public UMemory, public FormattedValue {
 /**
  * See the main description in numberrangeformatter.h for documentation and examples.
  *
 /**
  * See the main description in numberrangeformatter.h for documentation and examples.
  *

- * @draft ICU 63
+ * @stable ICU 63

  */
 class U_I18N_API NumberRangeFormatter final {
   public:
  */
 class U_I18N_API NumberRangeFormatter final {
   public:


@@ -877,7 +882,7 @@ class U_I18N_API NumberRangeFormatter final {
      * known at the call site.
      *
      * @return An {@link UnlocalizedNumberRangeFormatter}, to be used for chaining.
      * known at the call site.
      *
      * @return An {@link UnlocalizedNumberRangeFormatter}, to be used for chaining.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     static UnlocalizedNumberRangeFormatter with();
 
      */
     static UnlocalizedNumberRangeFormatter with();
 


@@ -888,7 +893,7 @@ class U_I18N_API NumberRangeFormatter final {
      * @param locale
      *            The locale from which to load formats and symbols for number range formatting.
      * @return A {@link LocalizedNumberRangeFormatter}, to be used for chaining.
      * @param locale
      *            The locale from which to load formats and symbols for number range formatting.
      * @return A {@link LocalizedNumberRangeFormatter}, to be used for chaining.

-     * @draft ICU 63
+     * @stable ICU 63

      */
     static LocalizedNumberRangeFormatter withLocale(const Locale &locale);
 
      */
     static LocalizedNumberRangeFormatter withLocale(const Locale &locale);
 


@@ -900,10 +905,10 @@ class U_I18N_API NumberRangeFormatter final {
 
 }  // namespace number
 U_NAMESPACE_END
 
 }  // namespace number
 U_NAMESPACE_END

-#endif // U_SHOW_CPLUSPLUS_API

 
 

-#endif  // U_HIDE_DRAFT_API
+#endif /* #if !UCONFIG_NO_FORMATTING */
+
+#endif /* U_SHOW_CPLUSPLUS_API */

 
 #endif // __NUMBERRANGEFORMATTER_H__
 
 
 #endif // __NUMBERRANGEFORMATTER_H__
 

-#endif /* #if !UCONFIG_NO_FORMATTING */