]> granicus.if.org Git - icu/commitdiff
ICU-20796 BRS 65 update C API guard macros (manual version) (#827)
authorPeter Edberg <pedberg@unicode.org>
Wed, 11 Sep 2019 23:27:29 +0000 (16:27 -0700)
committerpedberg-icu <42151464+pedberg-icu@users.noreply.github.com>
Fri, 13 Sep 2019 17:56:25 +0000 (10:56 -0700)
12 files changed:
icu4c/source/common/unicode/bytestrie.h
icu4c/source/common/unicode/localebuilder.h
icu4c/source/common/unicode/ucharstrie.h
icu4c/source/common/unicode/uniset.h
icu4c/source/i18n/unicode/calendar.h
icu4c/source/i18n/unicode/dcfmtsym.h
icu4c/source/i18n/unicode/dtptngen.h
icu4c/source/i18n/unicode/formattedvalue.h
icu4c/source/i18n/unicode/numberformatter.h
icu4c/source/i18n/unicode/numberrangeformatter.h
icu4c/source/i18n/unicode/plurfmt.h
icu4c/source/i18n/unicode/ulistformatter.h

index 8d5420f3fbca7ae1108ce318bd69c6c224e6ab25..51405f64a10e64f8bf9d82a88723e6d6d671e7ff 100644 (file)
@@ -97,6 +97,7 @@ public:
         return *this;
     }
 
+#ifndef U_HIDE_DRAFT_API
     /**
      * Returns the state of this trie as a 64-bit integer.
      * The state value is never 0.
@@ -129,6 +130,7 @@ public:
         pos_ = bytes_ + (state & kState64PosMask);
         return *this;
     }
+#endif  /* U_HIDE_DRAFT_API */
 
     /**
      * BytesTrie state object, for saving a trie's current state
index 6805ab1a4d1e55f30b9f6f89de220a80569338d9..19e10f1c0709240ae5cfb7a7df8bed244a5087c9 100644 (file)
@@ -279,6 +279,7 @@ public:
      */
     Locale build(UErrorCode& status);
 
+#ifndef U_HIDE_DRAFT_API
     /**
      * Sets the UErrorCode if an error occurred while recording sets.
      * Preserves older error codes in the outErrorCode.
@@ -289,6 +290,7 @@ public:
      * @draft ICU 65
      */
     UBool copyErrorTo(UErrorCode &outErrorCode) const;
+#endif  /* U_HIDE_DRAFT_API */
 
 private:
     friend class LocaleMatcher::Result;
index 8bc914e24d6354e77e904bee32e9bb555db6b821..d5729d944ee3a2a79deda051aa9bf9eb21d60425 100644 (file)
@@ -97,6 +97,7 @@ public:
         return *this;
     }
 
+#ifndef U_HIDE_DRAFT_API
     /**
      * Returns the state of this trie as a 64-bit integer.
      * The state value is never 0.
@@ -129,6 +130,7 @@ public:
         pos_ = uchars_ + (state & kState64PosMask);
         return *this;
     }
+#endif  /* U_HIDE_DRAFT_API */
 
     /**
      * UCharsTrie state object, for saving a trie's current state
index c8525ad2c0b0d59682120eafb16133826c4016bf..974231100353f5a31b83bf38ce140f1188f8d716 100644 (file)
@@ -1655,11 +1655,10 @@ private:
                      const UnicodeSet* inclusions,
                      UErrorCode &status);
 
-#ifndef U_HIDE_DRAFT_API   // Skipped: ucpmap.h is draft only.
+    // UCPMap is now stable ICU 63
     void applyIntPropertyValue(const UCPMap *map,
                                UCPMapValueFilter *filter, const void *context,
                                UErrorCode &errorCode);
-#endif  /* U_HIDE_DRAFT_API */
 
     /**
      * Set the new pattern to cache.
index 6d9d1e40289ab16792e2a3cbe05e93e779d8f150..47167114ab354820f307ec3a8a64f5994d7297f5 100644 (file)
@@ -2283,7 +2283,6 @@ private:
      * should only be called if this calendar is not lenient.
      * @see #isLenient
      * @see #validateField(int, int&)
-     * @internal
      */
     void validateFields(UErrorCode &status);
 
@@ -2293,7 +2292,6 @@ private:
      * <code>U_ILLEGAL_ARGUMENT_ERROR</code> will be set.  Subclasses may
      * use this method in their implementation of {@link
      * #validateField(int, int&)}.
-     * @internal
      */
     void validateField(UCalendarDateFields field, int32_t min, int32_t max, UErrorCode& status);
 
index 28ebbe58bf0167c10fe9375a8cd9eeee684af73b..e1e0ab6b08c523406c6055799833214850ad47dc 100644 (file)
@@ -457,13 +457,11 @@ private:
      * to non-resource bundle strings,
      * then regular UnicodeString copies must be used instead of fastCopyFrom().
      *
-     * @internal
      */
     UnicodeString fSymbols[kFormatSymbolCount];
 
     /**
      * Non-symbol variable for getConstSymbol(). Always empty.
-     * @internal
      */
     UnicodeString fNoSymbol;
 
index 6cb138788625c9f424f34ce52dd33bbb9f8461dd..a71938b31cf5d8279a29110109cf7a329589041e 100644 (file)
@@ -565,12 +565,10 @@ private:
     void setDateTimeFromCalendar(const Locale& locale, UErrorCode& status);
     void setDecimalSymbols(const Locale& locale, UErrorCode& status);
     UDateTimePatternField getAppendFormatNumber(const char* field) const;
-#ifndef U_HIDE_DRAFT_API
-    // The following three have to be U_HIDE_DRAFT_API (though private) because UDateTimePGDisplayWidth is
+    // Note for the next 3: UDateTimePGDisplayWidth is now stable ICU 61
     UDateTimePatternField getFieldAndWidthIndices(const char* key, UDateTimePGDisplayWidth* widthP) const;
     void setFieldDisplayName(UDateTimePatternField field, UDateTimePGDisplayWidth width, const UnicodeString& value);
     UnicodeString& getMutableFieldDisplayName(UDateTimePatternField field, UDateTimePGDisplayWidth width);
-#endif  // U_HIDE_DRAFT_API
     void getAppendName(UDateTimePatternField field, UnicodeString& value);
     UnicodeString mapSkeletonMetacharacters(const UnicodeString& patternForm, int32_t* flags, UErrorCode& status);
     const UnicodeString* getBestRaw(DateTimeMatcher& source, int32_t includeMask, DistanceInfo* missingFields, UErrorCode& status, const PtnSkeleton** specifiedSkeletonPtr = 0);
index faf93a20dff1fb5612ffca84777431e11a6ab8a7..61fdb8ec6afc7fd4745ef8e8c008969b77d119a8 100644 (file)
@@ -26,7 +26,9 @@ U_NAMESPACE_BEGIN
  */
 
 
-#ifndef U_HIDE_DRAFT_API
+// The following cannot have #ifndef U_HIDE_DRAFT_API because
+// class FormattedValue depends on it, and FormattedValue cannot be
+// hidden becauseclass FormattedNumber (stable ICU 60) depends on it.
 /**
  * Represents a span of a string containing a given field.
  *
@@ -55,6 +57,7 @@ class U_I18N_API ConstrainedFieldPosition : public UMemory {
     /** @draft ICU 64 */
     ~ConstrainedFieldPosition();
 
+#ifndef U_HIDE_DRAFT_API
     /**
      * Resets this ConstrainedFieldPosition to its initial state, as if it were newly created:
      *
@@ -224,18 +227,23 @@ class U_I18N_API ConstrainedFieldPosition : public UMemory {
         int32_t field,
         int32_t start,
         int32_t limit);
+#endif  /* U_HIDE_DRAFT_API */
 
   private:
     int64_t fContext = 0LL;
     int32_t fField = 0;
     int32_t fStart = 0;
     int32_t fLimit = 0;
+#ifndef U_HIDE_DRAFT_API
     int32_t fCategory = UFIELD_CATEGORY_UNDEFINED;
+#else   /* U_HIDE_DRAFT_API */
+    int32_t fCategory = 0;
+#endif  /* U_HIDE_DRAFT_API */
     int8_t fConstraint = 0;
 };
 
-#endif // U_HIDE_DRAFT_API
-
+// The following cannot have #ifndef U_HIDE_DRAFT_API because
+// class FormattedNumber (stable ICU 60) depends on it.
 /**
  * An abstract formatted value: a string with associated field attributes.
  * Many formatters format to classes implementing FormattedValue.
@@ -288,7 +296,6 @@ class U_I18N_API FormattedValue /* not : public UObject because this is an inter
      */
     virtual Appendable& appendTo(Appendable& appendable, UErrorCode& status) const = 0;
 
-#ifndef U_HIDE_DRAFT_API
     /**
      * Iterates over field positions in the FormattedValue. This lets you determine the position
      * of specific types of substrings, like a month or a decimal separator.
@@ -312,7 +319,6 @@ class U_I18N_API FormattedValue /* not : public UObject because this is an inter
      * @draft ICU 64
      */
     virtual UBool nextPosition(ConstrainedFieldPosition& cfpos, UErrorCode& status) const = 0;
-#endif
 };
 
 
index 7049764ba34a40cad6ebc2ce90c457e787cf591c..82d2e3c596efa21f67120ebddc29bcdd02eeb2b8 100644 (file)
@@ -2410,14 +2410,14 @@ class U_I18N_API LocalizedNumberFormatter
 class U_I18N_API FormattedNumber : public UMemory, public FormattedValue {
   public:
 
-#ifndef U_HIDE_DRAFT_API
+    // Default constructor cannot have #ifndef U_HIDE_DRAFT_API
     /**
      * Default constructor; makes an empty FormattedNumber.
      * @draft ICU 64
      */
     FormattedNumber()
         : fData(nullptr), fErrorCode(U_INVALID_STATE_ERROR) {}
-#endif
+
     /**
      * Move constructor: Leaves the source FormattedNumber in an undefined state.
      * @stable ICU 62
@@ -2466,11 +2466,11 @@ class U_I18N_API FormattedNumber : public UMemory, public FormattedValue {
      */
     Appendable &appendTo(Appendable& appendable, UErrorCode& status) const U_OVERRIDE;
 
-#ifndef U_HIDE_DRAFT_API
     // Copydoc: this method is new in ICU 64
     /** @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,
@@ -2522,7 +2522,9 @@ class U_I18N_API FormattedNumber : public UMemory, public FormattedValue {
      * @see UNumberFormatFields
      */
     void getAllFieldPositions(FieldPositionIterator &iterator, UErrorCode &status) const;
+#endif  /* U_HIDE_DRAFT_API */
 
+#ifndef U_HIDE_DRAFT_API
     /**
      * Export the formatted number as a "numeric string" conforming to the
      * syntax defined in the Decimal Arithmetic Specification, available at
index b8f3ff55beb6e6a484708b822bdf9ac52fb0c2c7..0f0d2af5f5b2af960ff218d3204fef27eaf60ffb 100644 (file)
@@ -449,6 +449,7 @@ class U_I18N_API NumberRangeFormatterSettings {
      */
     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.
@@ -470,6 +471,7 @@ class U_I18N_API NumberRangeFormatterSettings {
      * @draft ICU 64
      */
     LocalPointer<Derived> clone() &&;
+#endif  /* U_HIDE_DRAFT_API */
 
     /**
      * Sets the UErrorCode if an error occurred in the fluent chain.
@@ -654,7 +656,7 @@ class U_I18N_API LocalizedNumberRangeFormatter
     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.
@@ -721,11 +723,11 @@ class U_I18N_API FormattedNumberRange : public UMemory, public FormattedValue {
      */
     Appendable &appendTo(Appendable &appendable, UErrorCode& status) const U_OVERRIDE;
 
-#ifndef U_HIDE_DRAFT_API
     // Copydoc: this method is new in ICU 64
     /** @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,
@@ -855,7 +857,6 @@ class U_I18N_API FormattedNumberRange : public UMemory, public FormattedValue {
 
     /**
      * Internal constructor from data type. Adopts the data pointer.
-     * @internal
      */
     explicit FormattedNumberRange(impl::UFormattedNumberRangeData *results)
         : fData(results), fErrorCode(U_ZERO_ERROR) {}
index fb9a43344c091e1d01729052204b174c67636e93..2c2116586f6e8419770e92e497afd7fca8643e05 100644 (file)
@@ -524,7 +524,7 @@ public:
 
 private:
      /**
-      * @internal
+      * @internal (private)
       */
     class U_I18N_API PluralSelector : public UMemory {
       public:
@@ -536,14 +536,11 @@ private:
          * @param number The number to be plural-formatted.
          * @param ec Error code.
          * @return The selected PluralFormat keyword.
-         * @internal
+         * @internal (private)
          */
         virtual UnicodeString select(void *context, double number, UErrorCode& ec) const = 0;
     };
 
-    /**
-     * @internal
-     */
     class U_I18N_API PluralSelectorAdapter : public PluralSelector {
       public:
         PluralSelectorAdapter() : pluralRules(NULL) {
@@ -551,7 +548,7 @@ private:
 
         virtual ~PluralSelectorAdapter();
 
-        virtual UnicodeString select(void *context, double number, UErrorCode& /*ec*/) const; /**< @internal */
+        virtual UnicodeString select(void *context, double number, UErrorCode& /*ec*/) const;
 
         void reset();
 
@@ -575,7 +572,7 @@ private:
     UnicodeString& format(const Formattable& numberObject, double number,
                           UnicodeString& appendTo,
                           FieldPosition& pos,
-                          UErrorCode& status) const; /**< @internal */
+                          UErrorCode& status) const;
 
     /**
      * Finds the PluralFormat sub-message for the given number, or the "other" sub-message.
index e39030515010a671a2fc080965fe8e86493eb266..1a39008889803b63ce73562ed676837faef6649c 100644 (file)
@@ -41,7 +41,9 @@ struct UFormattedList;
  * @draft ICU 64
  */
 typedef struct UFormattedList UFormattedList;
+#endif  /* U_HIDE_DRAFT_API */
 
+#ifndef U_HIDE_DRAFT_API
 /**
  * FieldPosition and UFieldPosition selectors for format fields
  * defined by ListFormatter.