organicmaps/icu
13
Fork 0
mirror of https://github.com/unicode-org/icu.git synced 2025-04-05 13:35:32 +00:00
Code Issues 1 Projects Releases Wiki Activity Actions 12

ICU-22534 Promote (almost) all @draft ICU 73 APIs to @stable ICU 73

Browse source
This commit is contained in:
Rich Gillam 2024-02-22 18:47:10 -08:00 • committed by Rich Gillam
parent 232362bf17
commit c610d7f986
7 changed files with 50 additions and 67 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
icu4c/source/common/unicode/uset.h
View file

@ -109,7 +109,6 @@ enum {
*/
USET_ADD_CASE_MAPPINGS = 4,
#ifndef U_HIDE_DRAFT_API
/**
* Enable case insensitive matching.
* Same as USET_CASE_INSENSITIVE but using only Simple_Case_Folding (scf) mappings,
@ -120,10 +119,9 @@ enum {
* regular expression implementations where only Simple_Case_Folding mappings are used,
* such as in ECMAScript (JavaScript) regular expressions.
*
* @draft ICU 73
* @stable ICU 73
*/
USET_SIMPLE_CASE_INSENSITIVE = 6
#endif // U_HIDE_DRAFT_API
};
/**

9
icu4c/source/i18n/unicode/calendar.h
View file

@ -1350,7 +1350,6 @@ public:
*/
virtual UBool isWeekend() const;
#ifndef U_FORCE_HIDE_DRAFT_API
/**
* Returns true if the date is in a leap year. Recalculate the current time
* field values if the time value has been changed by a call to * setTime().
@ -1363,7 +1362,7 @@ public:
* @param status ICU Error Code
* @return True if the date in the fields is in a Temporal proposal
* defined leap year. False otherwise.
* @draft ICU 73
* @stable ICU 73
*/
virtual bool inTemporalLeapYear(UErrorCode& status) const;
@ -1383,7 +1382,7 @@ public:
*
* @param status ICU Error Code
* @return One of 25 possible strings in {"M01".."M13", "M01L".."M12L"}.
* @draft ICU 73
* @stable ICU 73
*/
virtual const char* getTemporalMonthCode(UErrorCode& status) const;
@ -1404,12 +1403,10 @@ public:
* @param temporalMonth The value to be set for temporal monthCode.
* @param status ICU Error Code
*
* @draft ICU 73
* @stable ICU 73
*/
virtual void setTemporalMonthCode(const char* temporalMonth, UErrorCode& status);
#endif // U_FORCE_HIDE_DRAFT_API
protected:
/**

6
icu4c/source/i18n/unicode/measunit.h
View file

@ -3068,23 +3068,21 @@ class U_I18N_API MeasureUnit: public UObject {
*/
static MeasureUnit getPoundPerSquareInch();
#ifndef U_HIDE_DRAFT_API
/**
* Returns by pointer, unit of speed: beaufort.
* Caller owns returned value and must free it.
* Also see {@link #getBeaufort()}.
* @param status ICU error code.
* @draft ICU 73
* @stable ICU 73
*/
static MeasureUnit *createBeaufort(UErrorCode &status);
/**
* Returns by value, unit of speed: beaufort.
* Also see {@link #createBeaufort()}.
* @draft ICU 73
* @stable ICU 73
*/
static MeasureUnit getBeaufort();
#endif /* U_HIDE_DRAFT_API */
/**
* Returns by pointer, unit of speed: kilometer-per-hour.

8
icu4c/source/i18n/unicode/numfmt.h
View file

@ -199,23 +199,21 @@ public:
* @stable ICU 4.8
*/
kRoundUnnecessary,
#ifndef U_HIDE_DRAFT_API
/**
* Rounds ties toward the odd number.
* @draft ICU 73
* @stable ICU 73
*/
kRoundHalfOdd,
/**
* Rounds ties toward +∞.
* @draft ICU 73
* @stable ICU 73
*/
kRoundHalfCeiling,
/**
* Rounds ties toward -∞.
* @draft ICU 73
* @stable ICU 73
*/
kRoundHalfFloor,
#endif /* U_HIDE_DRAFT_API */
};
/**

43
icu4c/source/i18n/unicode/simplenumberformatter.h
View file

@ -43,22 +43,19 @@ class AdoptingSignumModifierStore;
} // icu::number::impl
#ifndef U_HIDE_DRAFT_API
/**
* An input type for SimpleNumberFormatter.
*
* This class is mutable and not intended for public subclassing. This class is movable but not copyable.
*
* @draft ICU 73
* @stable ICU 73
*/
class U_I18N_API SimpleNumber : public UMemory {
public:
/**
* Creates a SimpleNumber for an integer.
*
* @draft ICU 73
* @stable ICU 73
*/
static SimpleNumber forInt64(int64_t value, UErrorCode& status);
@ -67,10 +64,11 @@ class U_I18N_API SimpleNumber : public UMemory {
*
* This function immediately mutates the inner value.
*
* @draft ICU 73
* @stable ICU 73
*/
void multiplyByPowerOfTen(int32_t power, UErrorCode& status);
#ifndef U_HIDE_DRAFT_API
/**
* Rounds the value currently stored in the SimpleNumber to the given power of 10.
*
@ -107,6 +105,7 @@ class U_I18N_API SimpleNumber : public UMemory {
*/
void setMinimumFractionDigits(uint32_t minimumFractionDigits, UErrorCode& status);
#endif // U_HIDE_DRAFT_API
/**
* Sets the sign of the number: an explicit plus sign, explicit minus sign, or no sign.
*
@ -114,7 +113,7 @@ class U_I18N_API SimpleNumber : public UMemory {
*
* NOTE: This does not support accounting sign notation.
*
* @draft ICU 73
* @stable ICU 73
*/
void setSign(USimpleNumberSign sign, UErrorCode& status);
@ -123,14 +122,14 @@ class U_I18N_API SimpleNumber : public UMemory {
*
* NOTE: This number will fail to format; use forInt64() to create a SimpleNumber with a value.
*
* @draft ICU 73
* @stable ICU 73
*/
SimpleNumber() = default;
/**
* Destruct this SimpleNumber, cleaning up any memory it might own.
*
* @draft ICU 73
* @stable ICU 73
*/
~SimpleNumber() {
cleanup();
@ -139,7 +138,7 @@ class U_I18N_API SimpleNumber : public UMemory {
/**
* SimpleNumber move constructor.
*
* @draft ICU 73
* @stable ICU 73
*/
SimpleNumber(SimpleNumber&& other) noexcept {
fData = other.fData;
@ -150,7 +149,7 @@ class U_I18N_API SimpleNumber : public UMemory {
/**
* SimpleNumber move assignment.
*
* @draft ICU 73
* @stable ICU 73
*/
SimpleNumber& operator=(SimpleNumber&& other) noexcept {
cleanup();
@ -185,14 +184,14 @@ class U_I18N_API SimpleNumber : public UMemory {
*
* This class is immutable and not intended for public subclassing. This class is movable but not copyable.
*
* @draft ICU 73
* @stable ICU 73
*/
class U_I18N_API SimpleNumberFormatter : public UMemory {
public:
/**
* Creates a new SimpleNumberFormatter with all locale defaults.
*
* @draft ICU 73
* @stable ICU 73
*/
static SimpleNumberFormatter forLocale(
const icu::Locale &locale,
@ -201,7 +200,7 @@ class U_I18N_API SimpleNumberFormatter : public UMemory {
/**
* Creates a new SimpleNumberFormatter, overriding the grouping strategy.
*
* @draft ICU 73
* @stable ICU 73
*/
static SimpleNumberFormatter forLocaleAndGroupingStrategy(
const icu::Locale &locale,
@ -214,7 +213,7 @@ class U_I18N_API SimpleNumberFormatter : public UMemory {
* IMPORTANT: For efficiency, this function borrows the symbols. The symbols MUST remain valid
* for the lifetime of the SimpleNumberFormatter.
*
* @draft ICU 73
* @stable ICU 73
*/
static SimpleNumberFormatter forLocaleAndSymbolsAndGroupingStrategy(
const icu::Locale &locale,
@ -228,7 +227,7 @@ class U_I18N_API SimpleNumberFormatter : public UMemory {
* The SimpleNumber argument is "consumed". A new SimpleNumber object should be created for
* every formatting operation.
*
* @draft ICU 73
* @stable ICU 73
*/
FormattedNumber format(SimpleNumber value, UErrorCode &status) const;
@ -237,7 +236,7 @@ class U_I18N_API SimpleNumberFormatter : public UMemory {
*
* For more control over the formatting, use SimpleNumber.
*
* @draft ICU 73
* @stable ICU 73
*/
FormattedNumber formatInt64(int64_t value, UErrorCode &status) const {
return format(SimpleNumber::forInt64(value, status), status);
@ -254,7 +253,7 @@ class U_I18N_API SimpleNumberFormatter : public UMemory {
/**
* Destruct this SimpleNumberFormatter, cleaning up any memory it might own.
*
* @draft ICU 73
* @stable ICU 73
*/
~SimpleNumberFormatter() {
cleanup();
@ -263,14 +262,14 @@ class U_I18N_API SimpleNumberFormatter : public UMemory {
/**
* Creates a shell, initialized but non-functional SimpleNumberFormatter.
*
* @draft ICU 73
* @stable ICU 73
*/
SimpleNumberFormatter() = default;
/**
* SimpleNumberFormatter: Move constructor.
*
* @draft ICU 73
* @stable ICU 73
*/
SimpleNumberFormatter(SimpleNumberFormatter&& other) noexcept {
fGroupingStrategy = other.fGroupingStrategy;
@ -285,7 +284,7 @@ class U_I18N_API SimpleNumberFormatter : public UMemory {
/**
* SimpleNumberFormatter: Move assignment.
*
* @draft ICU 73
* @stable ICU 73
*/
SimpleNumberFormatter& operator=(SimpleNumberFormatter&& other) noexcept {
cleanup();
@ -321,8 +320,6 @@ class U_I18N_API SimpleNumberFormatter : public UMemory {
};
#endif // U_HIDE_DRAFT_API
} // namespace number
U_NAMESPACE_END

4
icu4c/source/i18n/unicode/ucal.h
View file

@ -442,7 +442,6 @@ enum UCalendarDateFields {
*/
UCAL_IS_LEAP_MONTH,
#ifndef U_HIDE_DRAFT_API
/**
* Field number indicating the month. This is a calendar-specific value.
* Differ from UCAL_MONTH, this value is continuous and unique within a
@ -464,10 +463,9 @@ enum UCalendarDateFields {
* and there is an extra "Leap Month 5" which associated with UCAL_ORDINAL_MONTH
* value 5 before "Month 6" of year 4664.
*
* @draft ICU 73
* @stable ICU 73
*/
UCAL_ORDINAL_MONTH,
#endif // U_HIDE_DRAFT_API
/* Do not conditionalize the following with #ifndef U_HIDE_DEPRECATED_API,
* it is needed for layout of Calendar, DateFormat, and other objects */

43
icu4c/source/i18n/unicode/usimplenumberformatter.h
View file

@ -50,31 +50,28 @@
* </pre>
*/
#ifndef U_HIDE_DRAFT_API
/**
* An explicit sign option for a SimpleNumber.
*
* @draft ICU 73
* @stable ICU 73
*/
typedef enum USimpleNumberSign {
/**
* Render a plus sign.
*
* @draft ICU 73
* @stable ICU 73
*/
UNUM_SIMPLE_NUMBER_PLUS_SIGN,
/**
* Render no sign.
*
* @draft ICU 73
* @stable ICU 73
*/
UNUM_SIMPLE_NUMBER_NO_SIGN,
/**
* Render a minus sign.
*
* @draft ICU 73
* @stable ICU 73
*/
UNUM_SIMPLE_NUMBER_MINUS_SIGN,
} USimpleNumberSign;
@ -84,7 +81,7 @@ struct USimpleNumber;
/**
* C-compatible version of icu::number::SimpleNumber.
*
* @draft ICU 73
* @stable ICU 73
*/
typedef struct USimpleNumber USimpleNumber;
@ -93,7 +90,7 @@ struct USimpleNumberFormatter;
/**
* C-compatible version of icu::number::SimpleNumberFormatter.
*
* @draft ICU 73
* @stable ICU 73
*/
typedef struct USimpleNumberFormatter USimpleNumberFormatter;
@ -101,7 +98,7 @@ typedef struct USimpleNumberFormatter USimpleNumberFormatter;
/**
* Creates a new USimpleNumber to be formatted with a USimpleNumberFormatter.
*
* @draft ICU 73
* @stable ICU 73
*/
U_CAPI USimpleNumber* U_EXPORT2
usnum_openForInt64(int64_t value, UErrorCode* ec);
@ -112,7 +109,7 @@ usnum_openForInt64(int64_t value, UErrorCode* ec);
*
* This can be used to reset the number value after formatting.
*
* @draft ICU 73
* @stable ICU 73
*/
U_CAPI void U_EXPORT2
usnum_setToInt64(USimpleNumber* unumber, int64_t value, UErrorCode* ec);
@ -123,12 +120,13 @@ usnum_setToInt64(USimpleNumber* unumber, int64_t value, UErrorCode* ec);
*
* This function immediately mutates the inner value.
*
* @draft ICU 73
* @stable ICU 73
*/
U_CAPI void U_EXPORT2
usnum_multiplyByPowerOfTen(USimpleNumber* unumber, int32_t power, UErrorCode* ec);
#ifndef U_HIDE_DRAFT_API
/**
* Rounds the value currently stored in the USimpleNumber to the given power of 10.
*
@ -172,6 +170,7 @@ usnum_setMinimumFractionDigits(USimpleNumber* unumber, int32_t minimumFractionDi
U_CAPI void U_EXPORT2
usnum_truncateStart(USimpleNumber* unumber, int32_t maximumIntegerDigits, UErrorCode* ec);
#endif // U_HIDE_DRAFT_API
/**
* Sets the sign of the number: an explicit plus sign, explicit minus sign, or no sign.
@ -180,7 +179,7 @@ usnum_truncateStart(USimpleNumber* unumber, int32_t maximumIntegerDigits, UError
*
* NOTE: This does not support accounting sign notation.
*
* @draft ICU 73
* @stable ICU 73
*/
U_CAPI void U_EXPORT2
usnum_setSign(USimpleNumber* unumber, USimpleNumberSign sign, UErrorCode* ec);
@ -189,7 +188,7 @@ usnum_setSign(USimpleNumber* unumber, USimpleNumberSign sign, UErrorCode* ec);
/**
* Creates a new USimpleNumberFormatter with all locale defaults.
*
* @draft ICU 73
* @stable ICU 73
*/
U_CAPI USimpleNumberFormatter* U_EXPORT2
usnumf_openForLocale(const char* locale, UErrorCode* ec);
@ -198,7 +197,7 @@ usnumf_openForLocale(const char* locale, UErrorCode* ec);
/**
* Creates a new USimpleNumberFormatter, overriding the grouping strategy.
*
* @draft ICU 73
* @stable ICU 73
*/
U_CAPI USimpleNumberFormatter* U_EXPORT2
usnumf_openForLocaleAndGroupingStrategy(
@ -211,7 +210,7 @@ usnumf_openForLocaleAndGroupingStrategy(
* The USimpleNumber is cleared after calling this function. It can be re-used via
* usnum_setToInt64.
*
* @draft ICU 73
* @stable ICU 73
*/
U_CAPI void U_EXPORT2
usnumf_format(
@ -226,7 +225,7 @@ usnumf_format(
*
* For more control over the formatting, use USimpleNumber.
*
* @draft ICU 73
* @stable ICU 73
*/
U_CAPI void U_EXPORT2
usnumf_formatInt64(
@ -241,7 +240,7 @@ usnumf_formatInt64(
*
* NOTE: Normally, a USimpleNumber should be adopted by usnumf_formatAndAdoptNumber.
*
* @draft ICU 73
* @stable ICU 73
*/
U_CAPI void U_EXPORT2
usnum_close(USimpleNumber* unumber);
@ -250,7 +249,7 @@ usnum_close(USimpleNumber* unumber);
/**
* Frees the memory held by a USimpleNumberFormatter.
*
* @draft ICU 73
* @stable ICU 73
*/
U_CAPI void U_EXPORT2
usnumf_close(USimpleNumberFormatter* uformatter);
@ -275,7 +274,7 @@ U_NAMESPACE_BEGIN
*
* @see LocalPointerBase
* @see LocalPointer
* @draft ICU 73
* @stable ICU 73
*/
U_DEFINE_LOCAL_OPEN_POINTER(LocalUSimpleNumberPointer, USimpleNumber, usnum_close);
@ -292,14 +291,12 @@ U_DEFINE_LOCAL_OPEN_POINTER(LocalUSimpleNumberPointer, USimpleNumber, usnum_clos
*
* @see LocalPointerBase
* @see LocalPointer
* @draft ICU 73
* @stable ICU 73
*/
U_DEFINE_LOCAL_OPEN_POINTER(LocalUSimpleNumberFormatterPointer, USimpleNumberFormatter, usnumf_close);
U_NAMESPACE_END
#endif // U_SHOW_CPLUSPLUS_API
#endif // U_HIDE_DRAFT_API
#endif /* #if !UCONFIG_NO_FORMATTING */
#endif //__USIMPLENUMBERFORMATTER_H__