diff --git a/icu4c/source/i18n/unicode/calendar.h b/icu4c/source/i18n/unicode/calendar.h index df129f82a7..ba6ba3a7ce 100644 --- a/icu4c/source/i18n/unicode/calendar.h +++ b/icu4c/source/i18n/unicode/calendar.h @@ -143,7 +143,7 @@ U_NAMESPACE_BEGIN * For example, subtracting 5 days from the date September 12, 1996 * results in September 7, 1996. * - * @stable + * @stable ICU 2.0 */ class U_I18N_API Calendar : public UObject { public: @@ -152,7 +152,7 @@ public: * Field IDs for date and time. Used to specify date/time fields. ERA is calendar * specific. Example ranges given are for illustration only; see specific Calendar * subclasses for actual ranges. - * @stable + * @stable ICU 2.0 */ enum EDateFields { ERA, // Example: 0..1 @@ -184,7 +184,7 @@ public: * Useful constant for days of week. Note: Calendar day-of-week is 1-based. Clients * who create locale resources for the field of first-day-of-week should be aware of * this. For instance, in US locale, first-day-of-week is set to 1, i.e., SUNDAY. - * @stable + * @stable ICU 2.0 */ enum EDaysOfWeek { SUNDAY = 1, @@ -198,7 +198,7 @@ public: /** * Useful constants for month. Note: Calendar month is 0-based. - * @stable + * @stable ICU 2.0 */ enum EMonths { JANUARY, @@ -218,7 +218,7 @@ public: /** * Useful constants for hour in 12-hour clock. Used in GregorianCalendar. - * @stable + * @stable ICU 2.0 */ enum EAmpm { AM, @@ -227,7 +227,7 @@ public: /** * destructor - * @stable + * @stable ICU 2.0 */ virtual ~Calendar(); @@ -235,7 +235,7 @@ public: * Create and return a polymorphic copy of this calendar. * * @return a polymorphic copy of this calendar. - * @stable + * @stable ICU 2.0 */ virtual Calendar* clone(void) const = 0; @@ -247,7 +247,7 @@ public: * with U_ZERO_ERROR if created successfully, set to a failure result * otherwise. * @return A Calendar if created successfully. NULL otherwise. - * @stable + * @stable ICU 2.0 */ static Calendar* createInstance(UErrorCode& success); @@ -261,7 +261,7 @@ public: * with U_ZERO_ERROR if created successfully, set to a failure result * otherwise. * @return A Calendar if created successfully. NULL otherwise. - * @stable + * @stable ICU 2.0 */ static Calendar* createInstance(TimeZone* zoneToAdopt, UErrorCode& success); @@ -274,7 +274,7 @@ public: * with U_ZERO_ERROR if created successfully, set to a failure result * otherwise. * @return A Calendar if created successfully. NULL otherwise. - * @stable + * @stable ICU 2.0 */ static Calendar* createInstance(const TimeZone& zone, UErrorCode& success); @@ -286,7 +286,7 @@ public: * with U_ZERO_ERROR if created successfully, set to a failure result * otherwise. * @return A Calendar if created successfully. NULL otherwise. - * @stable + * @stable ICU 2.0 */ static Calendar* createInstance(const Locale& aLocale, UErrorCode& success); @@ -301,7 +301,7 @@ public: * with U_ZERO_ERROR if created successfully, set to a failure result * otherwise. * @return A Calendar if created successfully. NULL otherwise. - * @stable + * @stable ICU 2.0 */ static Calendar* createInstance(TimeZone* zoneToAdopt, const Locale& aLocale, UErrorCode& success); @@ -315,7 +315,7 @@ public: * with U_ZERO_ERROR if created successfully, set to a failure result * otherwise. * @return A Calendar if created successfully. NULL otherwise. - * @stable + * @stable ICU 2.0 */ static Calendar* createInstance(const TimeZone& zoneToAdopt, const Locale& aLocale, UErrorCode& success); @@ -326,7 +326,7 @@ public: * @return An array of Locale objects representing the set of locales for which * Calendars are installed. The system retains ownership of this list; * the caller must NOT delete it. - * @stable + * @stable ICU 2.0 */ static const Locale* getAvailableLocales(int32_t& count); @@ -335,7 +335,7 @@ public: * (derived from the system time). * * @return The current UTC time in milliseconds. - * @stable + * @stable ICU 2.0 */ static UDate getNow(void); @@ -350,7 +350,7 @@ public: * leniency, this will be set to an error status. * @return The current time in UTC (GMT) time, or zero if the operation * failed. - * @stable + * @stable ICU 2.0 */ inline UDate getTime(UErrorCode& status) const { return getTimeInMillis(status); } @@ -362,7 +362,7 @@ public: * @param status Output param set to success/failure code on exit. If any value * set in the time field is invalid or restricted by * leniency, this will be set to an error status. - * @stable + * @stable ICU 2.0 */ inline void setTime(UDate date, UErrorCode& status) { setTimeInMillis(date, status); } @@ -375,7 +375,7 @@ public: * @param that The Calendar object to be compared with. * @return True if the given Calendar is the same as this Calendar; false * otherwise. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const Calendar& that) const; @@ -385,7 +385,7 @@ public: * @param that The Calendar object to be compared with. * @return True if the given Calendar is not the same as this Calendar; false * otherwise. - * @stable + * @stable ICU 2.0 */ UBool operator!=(const Calendar& that) const {return !operator==(that);} @@ -413,7 +413,7 @@ public: * leniency, this will be set to an error status. * @return True if the current time of this Calendar is equal to the time of * Calendar when; false otherwise. - * @stable + * @stable ICU 2.0 */ UBool equals(const Calendar& when, UErrorCode& status) const; @@ -428,7 +428,7 @@ public: * leniency, this will be set to an error status. * @return True if the current time of this Calendar is before the time of * Calendar when; false otherwise. - * @stable + * @stable ICU 2.0 */ UBool before(const Calendar& when, UErrorCode& status) const; @@ -443,7 +443,7 @@ public: * leniency, this will be set to an error status. * @return True if the current time of this Calendar is after the time of * Calendar when; false otherwise. - * @stable + * @stable ICU 2.0 */ UBool after(const Calendar& when, UErrorCode& status) const; @@ -462,7 +462,7 @@ public: * @param status Output param set to success/failure code on exit. If any value * previously set in the time field is invalid or restricted by * leniency, this will be set to an error status. - * @stable + * @stable ICU 2.0 */ virtual void add(EDateFields field, int32_t amount, UErrorCode& status) = 0; @@ -487,7 +487,7 @@ public: * @param status Output param set to success/failure code on exit. If any value * previously set in the time field is invalid or restricted by * leniency, this will be set to an error status. - * @stable + * @stable ICU 2.0 */ void roll(EDateFields field, UBool up, UErrorCode& status); @@ -511,7 +511,7 @@ public: * @param status Output param set to success/failure code on exit. If any value * previously set in the time field is invalid, this will be set to * an error status. - * @stable + * @stable ICU 2.0 */ virtual void roll(EDateFields field, int32_t amount, UErrorCode& status) = 0; @@ -568,7 +568,7 @@ public: * @return the difference, either positive or negative, between * this calendar's time and when, in terms of * field. - * @stable + * @stable ICU 2.0 */ virtual int32_t fieldDifference(UDate when, EDateFields field, UErrorCode& status); @@ -578,7 +578,7 @@ public: * given time zone is NULL, this function has no effect. * * @param value The given time zone. - * @stable + * @stable ICU 2.0 */ void adoptTimeZone(TimeZone* value); @@ -587,7 +587,7 @@ public: * passed in is _not_ adopted; the client is still responsible for deleting it. * * @param value The given time zone. - * @stable + * @stable ICU 2.0 */ void setTimeZone(const TimeZone& zone); @@ -597,7 +597,7 @@ public: * or this Calendar is destroyed. * * @return The time zone object associated with this calendar. - * @stable + * @stable ICU 2.0 */ const TimeZone& getTimeZone(void) const; @@ -607,7 +607,7 @@ public: * with this Calendar is the default TimeZone as returned by TimeZone::createDefault(). * * @return The time zone object which was associated with this calendar. - * @stable + * @stable ICU 2.0 */ TimeZone* orphanTimeZone(void); @@ -617,7 +617,7 @@ public: * @param status Fill-in parameter which receives the status of this operation. * @return True if the current date for this Calendar is in Daylight Savings Time, * false, otherwise. - * @stable + * @stable ICU 2.0 */ virtual UBool inDaylightTime(UErrorCode& status) const = 0; @@ -631,7 +631,7 @@ public: * @param lenient True specifies date/time interpretation to be lenient. * * @see DateFormat#setLenient - * @stable + * @stable ICU 2.0 */ void setLenient(UBool lenient); @@ -639,7 +639,7 @@ public: * Tells whether date/time interpretation is to be lenient. * * @return True tells that date/time interpretation is to be lenient. - * @stable + * @stable ICU 2.0 */ UBool isLenient(void) const; @@ -647,7 +647,7 @@ public: * Sets what the first day of the week is; e.g., Sunday in US, Monday in France. * * @param value The given first day of the week. - * @stable + * @stable ICU 2.0 */ void setFirstDayOfWeek(EDaysOfWeek value); @@ -655,7 +655,7 @@ public: * Gets what the first day of the week is; e.g., Sunday in US, Monday in France. * * @return The first day of the week. - * @stable + * @stable ICU 2.0 */ EDaysOfWeek getFirstDayOfWeek(void) const; @@ -666,7 +666,7 @@ public: * use value 7. * * @param value The given minimal days required in the first week of the year. - * @stable + * @stable ICU 2.0 */ void setMinimalDaysInFirstWeek(uint8_t value); @@ -677,7 +677,7 @@ public: * be a full week, getMinimalDaysInFirstWeek returns 7. * * @return The minimal days required in the first week of the year. - * @stable + * @stable ICU 2.0 */ uint8_t getMinimalDaysInFirstWeek(void) const; @@ -687,7 +687,7 @@ public: * * @param field The given time field. * @return The minimum value for the given time field. - * @stable + * @stable ICU 2.0 */ virtual int32_t getMinimum(EDateFields field) const = 0; @@ -697,7 +697,7 @@ public: * * @param field The given time field. * @return The maximum value for the given time field. - * @stable + * @stable ICU 2.0 */ virtual int32_t getMaximum(EDateFields field) const = 0; @@ -707,7 +707,7 @@ public: * * @param field The given time field. * @return The highest minimum value for the given time field. - * @stable + * @stable ICU 2.0 */ virtual int32_t getGreatestMinimum(EDateFields field) const = 0; @@ -717,7 +717,7 @@ public: * * @param field The given time field. * @return The lowest maximum value for the given time field. - * @stable + * @stable ICU 2.0 */ virtual int32_t getLeastMaximum(EDateFields field) const = 0; @@ -733,7 +733,7 @@ public: * @param field the field to determine the minimum of * @param status Fill-in parameter which receives the status of this operation. * @return the minimum of the given field for the current date of this Calendar - * @stable + * @stable ICU 2.0 */ int32_t getActualMinimum(EDateFields field, UErrorCode& status) const; @@ -751,7 +751,7 @@ public: * @param field the field to determine the maximum of * @param status Fill-in parameter which receives the status of this operation. * @return the maximum of the given field for the current date of this Calendar - * @stable + * @stable ICU 2.0 */ int32_t getActualMaximum(EDateFields field, UErrorCode& status) const; @@ -766,7 +766,7 @@ public: * @param status Fill-in parameter which receives the status of the operation. * @return The value for the given time field, or zero if the field is unset, * and set() has been called for any other field. - * @stable + * @stable ICU 2.0 */ int32_t get(EDateFields field, UErrorCode& status) const; @@ -776,7 +776,7 @@ public: * * @param field The given time field. * @return True if the given time field has a value set; false otherwise. - * @stable + * @stable ICU 2.0 */ UBool isSet(EDateFields field) const; @@ -785,7 +785,7 @@ public: * * @param field The given time field. * @param value The value to be set for the given time field. - * @stable + * @stable ICU 2.0 */ void set(EDateFields field, int32_t value); @@ -797,7 +797,7 @@ public: * @param month The value used to set the MONTH time field. Month value is 0-based. * e.g., 0 for January. * @param date The value used to set the DATE time field. - * @stable + * @stable ICU 2.0 */ void set(int32_t year, int32_t month, int32_t date); @@ -811,7 +811,7 @@ public: * @param date The value used to set the DATE time field. * @param hour The value used to set the HOUR_OF_DAY time field. * @param minute The value used to set the MINUTE time field. - * @stable + * @stable ICU 2.0 */ void set(int32_t year, int32_t month, int32_t date, int32_t hour, int32_t minute); @@ -826,7 +826,7 @@ public: * @param hour The value used to set the HOUR_OF_DAY time field. * @param minute The value used to set the MINUTE time field. * @param second The value used to set the SECOND time field. - * @stable + * @stable ICU 2.0 */ void set(int32_t year, int32_t month, int32_t date, int32_t hour, int32_t minute, int32_t second); @@ -834,7 +834,7 @@ public: * Clears the values of all the time fields, making them both unset and assigning * them a value of zero. The field values will be determined during the next * resolving of time into time fields. - * @stable + * @stable ICU 2.0 */ void clear(void); @@ -844,7 +844,7 @@ public: * time into time fields. * * @param field The time field to be cleared. - * @stable + * @stable ICU 2.0 */ void clear(EDateFields field); @@ -861,7 +861,7 @@ public: * * @return The class ID for this object. All objects of a given class have the * same class ID. Objects of other classes have different class IDs. - * @stable + * @stable ICU 2.0 */ virtual UClassID getDynamicClassID(void) const = 0; @@ -873,7 +873,7 @@ protected: * * @param success Indicates the status of Calendar object construction. Returns * U_ZERO_ERROR if constructed successfully. - * @stable + * @stable ICU 2.0 */ Calendar(UErrorCode& success); @@ -881,7 +881,7 @@ protected: * Copy constructor * * @param source Calendar object to be copied from - * @stable + * @stable ICU 2.0 */ Calendar(const Calendar& source); @@ -889,7 +889,7 @@ protected: * Default assignment operator * * @param right Calendar object to be copied - * @stable + * @stable ICU 2.0 */ Calendar& operator=(const Calendar& right); @@ -901,7 +901,7 @@ protected: * @param aLocale The given locale. * @param success Indicates the status of Calendar object construction. Returns * U_ZERO_ERROR if constructed successfully. - * @stable + * @stable ICU 2.0 */ Calendar(TimeZone* zone, const Locale& aLocale, UErrorCode& success); @@ -912,7 +912,7 @@ protected: * @param aLocale The given locale. * @param success Indicates the status of Calendar object construction. Returns * U_ZERO_ERROR if constructed successfully. - * @stable + * @stable ICU 2.0 */ Calendar(const TimeZone& zone, const Locale& aLocale, UErrorCode& success); @@ -922,7 +922,7 @@ protected: * @param status Output param set to success/failure code on exit. If any value * previously set in the time field is invalid or restricted by * leniency, this will be set to an error status. - * @stable + * @stable ICU 2.0 */ virtual void computeTime(UErrorCode& status) = 0; @@ -935,7 +935,7 @@ protected: * @param status Output param set to success/failure code on exit. If any value * previously set in the time field is invalid or restricted by * leniency, this will be set to an error status. - * @stable + * @stable ICU 2.0 */ virtual void computeFields(UErrorCode& status) = 0; @@ -946,7 +946,7 @@ protected: * previously set in the time field is invalid or restricted by * leniency, this will be set to an error status. * @return the current time as UTC milliseconds from the epoch. - * @stable + * @stable ICU 2.0 */ double getTimeInMillis(UErrorCode& status) const; @@ -956,7 +956,7 @@ protected: * @param status Output param set to success/failure code on exit. If any value * previously set in the time field is invalid or restricted by * leniency, this will be set to an error status. - * @stable + * @stable ICU 2.0 */ void setTimeInMillis( double millis, UErrorCode& status ); @@ -967,7 +967,7 @@ protected: * @param status Output param set to success/failure code on exit. If any value * previously set in the time field is invalid or restricted by * leniency, this will be set to an error status. - * @stable + * @stable ICU 2.0 */ void complete(UErrorCode& status); @@ -977,7 +977,7 @@ protected: * * @param field The given time field. * @return The value for the given time field. - * @stable + * @stable ICU 2.0 */ int32_t internalGet(EDateFields field) const {return fFields[field];} @@ -988,14 +988,14 @@ protected: * * @param field The given time field. * @param value The value for the given time field. - * @stable + * @stable ICU 2.0 */ void internalSet(EDateFields field, int32_t value); protected: /** * The flag which indicates if the current time is set in the calendar. - * @stable + * @stable ICU 2.0 */ UBool fIsTimeSet; @@ -1007,14 +1007,14 @@ protected: *

* This should really be named areFieldsInSync, but the old name is retained * for backward compatibility. - * @stable + * @stable ICU 2.0 */ UBool fAreFieldsSet; /** * True if all of the fields have been set. This is initially false, and set to * true by computeFields(). - * @stable + * @stable ICU 2.0 */ UBool fAreAllFieldsSet; @@ -1022,7 +1022,7 @@ protected: * Get the current time without recomputing. * * @return the current time without recomputing. - * @stable + * @stable ICU 2.0 */ UDate internalGetTime(void) const { return fTime; } @@ -1031,24 +1031,24 @@ protected: * * @param time The time to be set * @return the current time without recomputing. - * @stable + * @stable ICU 2.0 */ void internalSetTime(UDate time) { fTime = time; } /** * The time fields containing values into which the millis is computed. - * @stable + * @stable ICU 2.0 */ int32_t fFields[FIELD_COUNT]; /** * The flags which tell if a specified time field for the calendar is set. - * @stable + * @stable ICU 2.0 */ UBool fIsSet[FIELD_COUNT]; /** Special values of stamp[] - * @stable + * @stable ICU 2.0 */ enum { kUnset = 0, @@ -1060,7 +1060,7 @@ protected: * Pseudo-time-stamps which specify when each field was set. There * are two special values, UNSET and INTERNALLY_SET. Values from * MINIMUM_USER_SET to Integer.MAX_VALUE are legal user set values. - * @stable + * @stable ICU 2.0 */ int32_t fStamp[FIELD_COUNT]; diff --git a/icu4c/source/i18n/unicode/choicfmt.h b/icu4c/source/i18n/unicode/choicfmt.h index bccccb439d..1e928e3d4e 100644 --- a/icu4c/source/i18n/unicode/choicfmt.h +++ b/icu4c/source/i18n/unicode/choicfmt.h @@ -251,7 +251,7 @@ public: * @param pattern Pattern used to construct object. * @param status Output param to receive success code. If the * pattern cannot be parsed, set to failure code. - * @stable + * @stable ICU 2.0 */ ChoiceFormat(const UnicodeString& newPattern, UErrorCode& status); @@ -264,7 +264,7 @@ public: * @param limits Array of limit values. * @param formats Array of formats. * @param count Size of 'limits' and 'formats' arrays. - * @stable + * @stable ICU 2.0 */ ChoiceFormat(const double* limits, @@ -296,7 +296,7 @@ public: * Copy constructor. * * @param ChoiceFormat object to be copied from - * @stable + * @stable ICU 2.0 */ ChoiceFormat(const ChoiceFormat&); @@ -304,13 +304,13 @@ public: * Assignment operator. * * @param ChoiceFormat object to be copied - * @stable + * @stable ICU 2.0 */ const ChoiceFormat& operator=(const ChoiceFormat&); /** * Destructor. - * @stable + * @stable ICU 2.0 */ virtual ~ChoiceFormat(); @@ -319,7 +319,7 @@ public: * result and should delete it when done. * * @return a copy of this object - * @stable + * @stable ICU 2.0 */ virtual Format* clone(void) const; @@ -329,7 +329,7 @@ public: * * @param other ChoiceFormat object to be compared * @return true if other is the same as this. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const Format& other) const; @@ -339,7 +339,7 @@ public: * @param status Output param set to success/failure code on * exit. If the pattern is invalid, this will be * set to a failure result. - * @stable + * @stable ICU 2.0 */ virtual void applyPattern(const UnicodeString& pattern, UErrorCode& status); @@ -363,7 +363,7 @@ public: * @param pattern Output param which will recieve the pattern * Previous contents are deleted. * @return A reference to 'pattern' - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& toPattern(UnicodeString &pattern) const; @@ -409,7 +409,7 @@ public: * <= X < limit[i+1]. * @param formatsToCopy The format strings you want to use for each limit. * @param count The size of the above arrays. - * @stable + * @stable ICU 2.0 */ virtual void setChoices(const double* limitsToCopy, const UnicodeString* formatsToCopy, @@ -433,7 +433,7 @@ public: * * @param count The size of the limits arrays * @return the limits. - * @stable + * @stable ICU 2.0 */ virtual const double* getLimits(int32_t& count) const; @@ -451,7 +451,7 @@ public: * * @param count The size of the arrays * @return the formats. - * @stable + * @stable ICU 2.0 */ virtual const UnicodeString* getFormats(int32_t& count) const; @@ -464,7 +464,7 @@ public: * @param pos On input: an alignment field, if desired. * On output: the offsets of the alignment field. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format(double number, UnicodeString& appendTo, @@ -478,7 +478,7 @@ public: * @param pos On input: an alignment field, if desired. * On output: the offsets of the alignment field. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format(int32_t number, UnicodeString& appendTo, @@ -495,7 +495,7 @@ public: * @param success Output param set to success/failure code on * exit. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format(const Formattable* objs, int32_t cnt, @@ -514,7 +514,7 @@ public: * @param status Output param set to success/failure code on * exit. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format(const Formattable& obj, UnicodeString& appendTo, @@ -530,7 +530,7 @@ public: * @param status Output param set to success/failure code on * exit. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ UnicodeString& format(const Formattable& obj, UnicodeString& appendTo, @@ -545,7 +545,7 @@ public: * @param appendTo Output parameter to receive result. * Result is appended to existing contents. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ UnicodeString& format( double number, UnicodeString& appendTo) const; @@ -559,7 +559,7 @@ public: * @param appendTo Output parameter to receive result. * Result is appended to existing contents. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ UnicodeString& format( int32_t number, UnicodeString& appendTo) const; @@ -580,7 +580,7 @@ public: * On output, moved to after the last successfully * parse character. On parse failure, does not change. * @see NumberFormat::isParseIntegerOnly - * @stable + * @stable ICU 2.0 */ virtual void parse(const UnicodeString& text, Formattable& result, @@ -600,7 +600,7 @@ public: * If parse fails, return contents are undefined. * @param status Output param with the formatted string. * @see NumberFormat::isParseIntegerOnly - * @stable + * @stable ICU 2.0 */ virtual void parse(const UnicodeString& text, Formattable& result, @@ -617,7 +617,7 @@ public: * @return The class ID for this object. All objects of a * given class have the same class ID. Objects of * other classes have different class IDs. - * @stable + * @stable ICU 2.0 */ virtual UClassID getDynamicClassID(void) const; @@ -630,7 +630,7 @@ public: * . Derived::getStaticClassID()) ... * * @return The class ID for all objects of this class. - * @stable + * @stable ICU 2.0 */ static UClassID getStaticClassID(void) { return (UClassID)&fgClassID; } @@ -700,7 +700,7 @@ private: * of error if an error is encountered. * @param status Output param to receive success code. If the * pattern cannot be parsed, set to failure code. - * @stable + * @stable ICU 2.0 */ ChoiceFormat(const UnicodeString& newPattern, UParseError& parseError, diff --git a/icu4c/source/i18n/unicode/coleitr.h b/icu4c/source/i18n/unicode/coleitr.h index 52ea9ec9bb..7a3158e34a 100644 --- a/icu4c/source/i18n/unicode/coleitr.h +++ b/icu4c/source/i18n/unicode/coleitr.h @@ -120,7 +120,7 @@ public: /** * NULLORDER indicates that an error has occured while processing - * @stable + * @stable ICU 2.0 */ static int32_t const NULLORDER; @@ -130,13 +130,13 @@ public: * Copy constructor. * * @param other the object to be copied from - * @stable + * @stable ICU 2.0 */ CollationElementIterator(const CollationElementIterator& other); /** * Destructor - * @stable + * @stable ICU 2.0 */ ~CollationElementIterator(); @@ -147,7 +147,7 @@ public: * * @param other the object to be compared * @return true if "other" is the same as "this" - * @stable + * @stable ICU 2.0 */ UBool operator==(const CollationElementIterator& other) const; @@ -156,13 +156,13 @@ public: * * @param other the object to be compared * @return true if "other" is not the same as "this" - * @stable + * @stable ICU 2.0 */ UBool operator!=(const CollationElementIterator& other) const; /** * Resets the cursor to the beginning of the string. - * @stable + * @stable ICU 2.0 */ void reset(void); @@ -171,7 +171,7 @@ public: * @param status the error code status. * @return the next character's ordering. otherwise returns NULLORDER if an * error has occured or if the end of string has been reached - * @stable + * @stable ICU 2.0 */ int32_t next(UErrorCode& status); @@ -180,7 +180,7 @@ public: * @param status the error code status. * @return the previous element's ordering. otherwise returns NULLORDER if an * error has occured or if the start of string has been reached - * @stable + * @stable ICU 2.0 */ int32_t previous(UErrorCode& status); @@ -188,7 +188,7 @@ public: * Gets the primary order of a collation order. * @param order the collation order * @return the primary order of a collation order. - * @stable + * @stable ICU 2.0 */ static int32_t primaryOrder(int32_t order); @@ -196,7 +196,7 @@ public: * Gets the secondary order of a collation order. * @param order the collation order * @return the secondary order of a collation order. - * @stable + * @stable ICU 2.0 */ static int32_t secondaryOrder(int32_t order); @@ -204,7 +204,7 @@ public: * Gets the tertiary order of a collation order. * @param order the collation order * @return the tertiary order of a collation order. - * @stable + * @stable ICU 2.0 */ static int32_t tertiaryOrder(int32_t order); @@ -215,7 +215,7 @@ public: * @return maximum size of the expansion sequences ending with the collation * element or 1 if collation element does not occur at the end of any * expansion sequence - * @stable + * @stable ICU 2.0 */ int32_t getMaxExpansion(int32_t order) const; @@ -223,7 +223,7 @@ public: * Gets the comparison order in the desired strength. Ignore the other * differences. * @param order The order value - * @stable + * @stable ICU 2.0 */ int32_t strengthOrder(int32_t order) const; @@ -231,7 +231,7 @@ public: * Sets the source string. * @param str the source string. * @param status the error code status. - * @stable + * @stable ICU 2.0 */ void setText(const UnicodeString& str, UErrorCode& status); @@ -239,7 +239,7 @@ public: * Sets the source string. * @param str the source character iterator. * @param status the error code status. - * @stable + * @stable ICU 2.0 */ void setText(CharacterIterator& str, UErrorCode& status); @@ -247,14 +247,14 @@ public: * Checks if a comparison order is ignorable. * @param order the collation order. * @return TRUE if a character is ignorable, FALSE otherwise. - * @stable + * @stable ICU 2.0 */ static UBool isIgnorable(int32_t order); /** * Gets the offset of the currently processed character in the source string. * @return the offset of the character. - * @stable + * @stable ICU 2.0 */ int32_t getOffset(void) const; @@ -263,7 +263,7 @@ public: * @param newOffset the new offset. * @param status the error code status. * @return the offset of the character. - * @stable + * @stable ICU 2.0 */ void setOffset(int32_t newOffset, UErrorCode& status); @@ -285,7 +285,7 @@ protected: // CollationElementIterator protected constructors -------------------------- /** - * @stable + * @stable ICU 2.0 */ friend class RuleBasedCollator; @@ -297,7 +297,7 @@ protected: * @param sourceText the source string. * @param order the collation object. * @param status the error code status. - * @stable + * @stable ICU 2.0 */ CollationElementIterator(const UnicodeString& sourceText, const RuleBasedCollator* order, UErrorCode& status); @@ -310,7 +310,7 @@ protected: * @param sourceText the source string. * @param order the collation object. * @param status the error code status. - * @stable + * @stable ICU 2.0 */ CollationElementIterator(const CharacterIterator& sourceText, const RuleBasedCollator* order, UErrorCode& status); @@ -321,7 +321,7 @@ protected: * Assignment operator * * @param other the object to be copied - * @stable + * @stable ICU 2.0 */ const CollationElementIterator& operator=(const CollationElementIterator& other); diff --git a/icu4c/source/i18n/unicode/coll.h b/icu4c/source/i18n/unicode/coll.h index f3e194592a..02fec6fcb9 100644 --- a/icu4c/source/i18n/unicode/coll.h +++ b/icu4c/source/i18n/unicode/coll.h @@ -57,7 +57,7 @@ U_NAMESPACE_BEGIN /** -* @stable +* @stable ICU 2.0 */ class CollationKey; @@ -188,7 +188,7 @@ public: * * UCollationStrength is also used to determine the strength of sort keys * generated from Collator objects. - * @stable + * @stable ICU 2.0 */ enum ECollationStrength { @@ -207,7 +207,7 @@ public: * GREATER is returned if source string is compared to be greater than * target string in the compare() method. * @see Collator#compare - * @stable + * @stable ICU 2.0 */ enum EComparisonResult { @@ -220,7 +220,7 @@ public: /** * Destructor - * @stable + * @stable ICU 2.0 */ virtual ~Collator(); @@ -230,7 +230,7 @@ public: * Returns true if "other" is the same as "this" * @param other Collator object to be compared * @return true if other is the same as this. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const Collator& other) const; @@ -238,14 +238,14 @@ public: * Returns true if "other" is not the same as "this". * @param other Collator object to be compared * @return true if other is not the same as this. - * @stable + * @stable ICU 2.0 */ virtual UBool operator!=(const Collator& other) const; /** * Makes a shallow copy of the current object. * @return a copy of this object - * @stable + * @stable ICU 2.0 */ virtual Collator* clone(void) const = 0; @@ -266,7 +266,7 @@ public: * @param err the error code status. * @return the collation object of the default locale.(for example, en_US) * @see Locale#getDefault - * @stable + * @stable ICU 2.0 */ static Collator* createInstance(UErrorCode& err); @@ -291,7 +291,7 @@ public: * locale. * @see Locale * @see ResourceLoader - * @stable + * @stable ICU 2.0 */ static Collator* createInstance(const Locale& loc, UErrorCode& err); @@ -326,7 +326,7 @@ public: * @return Returns a byte value. GREATER if source is greater * than target; EQUAL if source is equal to target; LESS if source is less * than target - * @stable + * @stable ICU 2.0 **/ virtual EComparisonResult compare(const UnicodeString& source, const UnicodeString& target) const = 0; @@ -341,7 +341,7 @@ public: * length) is greater than target; EQUAL if source (up to specified * length) is equal to target; LESS if source (up to the specified * length) is less than target. - * @stable + * @stable ICU 2.0 */ virtual EComparisonResult compare(const UnicodeString& source, const UnicodeString& target, @@ -360,7 +360,7 @@ public: * @return Returns a byte value. GREATER if source is greater than target; * EQUAL if source is equal to target; LESS if source is less than * target - * @stable + * @stable ICU 2.0 */ virtual EComparisonResult compare(const UChar* source, int32_t sourceLength, const UChar* target, int32_t targetLength) @@ -379,7 +379,7 @@ public: * @param status the error code status. * @return the collation key of the string based on the collation rules. * @see CollationKey#compare - * @stable + * @stable ICU 2.0 */ virtual CollationKey& getCollationKey(const UnicodeString& source, CollationKey& key, @@ -399,7 +399,7 @@ public: * @param status the error code status. * @return the collation key of the string based on the collation rules. * @see CollationKey#compare - * @stable + * @stable ICU 2.0 */ virtual CollationKey& getCollationKey(const UChar*source, int32_t sourceLength, @@ -407,7 +407,7 @@ public: UErrorCode& status) const = 0; /** * Generates the hash code for the collation object - * @stable + * @stable ICU 2.0 */ virtual int32_t hashCode(void) const = 0; @@ -430,7 +430,7 @@ public: * @return true if the first string is greater than the second one, * according to the collation rules. false, otherwise. * @see Collator#compare - * @stable + * @stable ICU 2.0 */ UBool greater(const UnicodeString& source, const UnicodeString& target) const; @@ -442,7 +442,7 @@ public: * @return true if the first string is greater than or equal to the second * one, according to the collation rules. false, otherwise. * @see Collator#compare - * @stable + * @stable ICU 2.0 */ UBool greaterOrEqual(const UnicodeString& source, const UnicodeString& target) const; @@ -453,7 +453,7 @@ public: * @return true if the strings are equal according to the collation rules. * false, otherwise. * @see Collator#compare - * @stable + * @stable ICU 2.0 */ UBool equals(const UnicodeString& source, const UnicodeString& target) const; @@ -465,7 +465,7 @@ public: * are ignored. * @return the current comparison level. * @see Collator#setStrength - * @stable + * @stable ICU 2.0 */ virtual ECollationStrength getStrength(void) const = 0; @@ -487,7 +487,7 @@ public: * * @see Collator#getStrength * @param newStrength the new comparison level. - * @stable + * @stable ICU 2.0 */ virtual void setStrength(ECollationStrength newStrength) = 0; @@ -498,7 +498,7 @@ public: * @param name the fill-in parameter of the return value * @return display-able name of the object for the object locale in the * desired language - * @stable + * @stable ICU 2.0 */ static UnicodeString& getDisplayName(const Locale& objectLocale, const Locale& displayLocale, @@ -509,7 +509,7 @@ public: * @param objectLocale must be from getAvailableLocales * @param name the fill-in parameter of the return value * @return name of the object for the desired locale in the default language - * @stable + * @stable ICU 2.0 */ static UnicodeString& getDisplayName(const Locale& objectLocale, UnicodeString& name); @@ -518,14 +518,14 @@ public: * Get the set of Locales for which Collations are installed * @param count the output parameter of number of elements in the locale list * @return the list of available locales which collations are installed - * @stable + * @stable ICU 2.0 */ static const Locale* getAvailableLocales(int32_t& count); /** * Gets the version information for a Collator. * @param info the version # information, the result will be filled in - * @stable + * @stable ICU 2.0 */ virtual void getVersion(UVersionInfo info) const = 0; @@ -544,7 +544,7 @@ public: * @return The class ID for this object. All objects of a given class have * the same class ID. Objects of other classes have different class * IDs. - * @stable + * @stable ICU 2.0 */ virtual UClassID getDynamicClassID(void) const = 0; @@ -578,7 +578,7 @@ public: * U_CE_NOT_FOUND_ERROR if more than one character was passed and there is no such a contraction
* U_PRIMARY_TOO_LONG_ERROR if the primary for the variable top has more than two bytes * @return a 32 bit value containing the value of the variable top in upper 16 bits. Lower 16 bits are undefined - * @stable + * @stable ICU 2.0 */ virtual uint32_t setVariableTop(const UChar *varTop, int32_t len, UErrorCode &status) = 0; @@ -589,7 +589,7 @@ public: * U_CE_NOT_FOUND_ERROR if more than one character was passed and there is no such a contraction
* U_PRIMARY_TOO_LONG_ERROR if the primary for the variable top has more than two bytes * @return a 32 bit value containing the value of the variable top in upper 16 bits. Lower 16 bits are undefined - * @stable + * @stable ICU 2.0 */ virtual uint32_t setVariableTop(const UnicodeString varTop, UErrorCode &status) = 0; @@ -598,7 +598,7 @@ public: * Lower 16 bits are ignored. * @param varTop CE value, as returned by setVariableTop or ucol)getVariableTop * @param status error code (not changed by function) - * @stable + * @stable ICU 2.0 */ virtual void setVariableTop(const uint32_t varTop, UErrorCode &status) = 0; @@ -606,7 +606,7 @@ public: * Gets the variable top value of a Collator. * Lower 16 bits are undefined and should be ignored. * @param status error code (not changed by function). If error code is set, the return value is undefined. - * @stable + * @stable ICU 2.0 */ virtual uint32_t getVariableTop(UErrorCode &status) const = 0; @@ -739,7 +739,7 @@ protected: * Constructor is different from the old default Collator constructor. * The task for determing the default collation strength and normalization * mode is left to the child class. - * @stable + * @stable ICU 2.0 */ Collator(); @@ -761,7 +761,7 @@ protected: /** * Copy constructor. * @param other Collator object to be copied from - * @stable + * @stable ICU 2.0 */ Collator(const Collator& other); diff --git a/icu4c/source/i18n/unicode/datefmt.h b/icu4c/source/i18n/unicode/datefmt.h index 71ef17c062..24419a1e47 100644 --- a/icu4c/source/i18n/unicode/datefmt.h +++ b/icu4c/source/i18n/unicode/datefmt.h @@ -237,13 +237,13 @@ public: /** * Destructor. - * @stable + * @stable ICU 2.0 */ virtual ~DateFormat(); /** * Equality operator. Returns true if the two formats have the same behavior. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const Format&) const; @@ -259,7 +259,7 @@ public: * On output: the offsets of the alignment field. * @param status Output param filled with success/failure status. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format(const Formattable& obj, UnicodeString& appendTo, @@ -324,7 +324,7 @@ public: * @param fieldPosition On input: an alignment field, if desired (see examples above) * On output: the offsets of the alignment field (see examples above) * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ UnicodeString& format( UDate date, UnicodeString& appendTo, @@ -339,7 +339,7 @@ public: * @param appendTo Output parameter to receive result. * Result is appended to existing contents. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ UnicodeString& format(UDate date, UnicodeString& appendTo) const; @@ -351,7 +351,7 @@ public: * Result is appended to existing contents. * @param status Output param filled with success/failure status. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ UnicodeString& format(const Formattable& obj, UnicodeString& appendTo, @@ -365,7 +365,7 @@ public: * 'text' cannot be parsed, it will be set to a failure * code. * @result The parsed UDate value, if successful. - * @stable + * @stable ICU 2.0 */ virtual UDate parse( const UnicodeString& text, UErrorCode& status) const; @@ -412,7 +412,7 @@ public: * output, the position at which parsing terminated, or the * start position if the parse failed. * @return A valid UDate if the input could be parsed. - * @stable + * @stable ICU 2.0 */ UDate parse( const UnicodeString& text, ParsePosition& pos) const; @@ -441,7 +441,7 @@ public: * @return A newly created Formattable* object, or NULL * on failure. The caller owns this and should * delete it when done. - * @stable + * @stable ICU 2.0 */ virtual void parseObject(const UnicodeString& source, Formattable& result, @@ -452,7 +452,7 @@ public: * the date and the time. * * @return A date/time formatter which the caller owns. - * @stable + * @stable ICU 2.0 */ static DateFormat* createInstance(void); @@ -464,7 +464,7 @@ public: * SHORT for "h:mm a" in the US locale. * @param aLocale The given locale. * @return A time formatter which the caller owns. - * @stable + * @stable ICU 2.0 */ static DateFormat* createTimeInstance(EStyle style = kDefault, const Locale& aLocale = Locale::getDefault()); @@ -477,7 +477,7 @@ public: * SHORT for "M/d/yy" in the US locale. * @param aLocale The given locale. * @return A date formatter which the caller owns. - * @stable + * @stable ICU 2.0 */ static DateFormat* createDateInstance(EStyle style = kDefault, const Locale& aLocale = Locale::getDefault()); @@ -492,7 +492,7 @@ public: * For example, SHORT for "h:mm a" in the US locale. * @param aLocale The given locale. * @return A date/time formatter which the caller owns. - * @stable + * @stable ICU 2.0 */ static DateFormat* createDateTimeInstance(EStyle dateStyle = kDefault, EStyle timeStyle = kDefault, @@ -503,13 +503,13 @@ public: * @param count Filled in with the number of locales in the list that is returned. * @return the set of locales for which DateFormats are installed. The caller * does NOT own this list and must not delete it. - * @stable + * @stable ICU 2.0 */ static const Locale* getAvailableLocales(int32_t& count); /** * Returns true if the formatter is set for lenient parsing. - * @stable + * @stable ICU 2.0 */ virtual UBool isLenient(void) const; @@ -521,14 +521,14 @@ public: * * @param lenient True specifies date/time interpretation to be lenient. * @see Calendar::setLenient - * @stable + * @stable ICU 2.0 */ virtual void setLenient(UBool lenient); /** * Gets the calendar associated with this date/time formatter. * @return the calendar associated with this date/time formatter. - * @stable + * @stable ICU 2.0 */ virtual const Calendar* getCalendar(void) const; @@ -538,7 +538,7 @@ public: * not delete the Calendar object after it is adopted by this call. * * @param calendarToAdopt Calendar object to be adopted. - * @stable + * @stable ICU 2.0 */ virtual void adoptCalendar(Calendar* calendarToAdopt); @@ -547,7 +547,7 @@ public: * calendar for the specified or default locale is used. * * @param newCalendar Calendar object to be set. - * @stable + * @stable ICU 2.0 */ virtual void setCalendar(const Calendar& newCalendar); @@ -556,7 +556,7 @@ public: * Gets the number formatter which this date/time formatter uses to format * and parse the numeric portions of the pattern. * @return the number formatter which this date/time formatter uses. - * @stable + * @stable ICU 2.0 */ virtual const NumberFormat* getNumberFormat(void) const; @@ -564,21 +564,21 @@ public: * Allows you to set the number formatter. The caller should * not delete the NumberFormat object after it is adopted by this call. * @param formatToAdopt NumberFormat object to be adopted. - * @stable + * @stable ICU 2.0 */ virtual void adoptNumberFormat(NumberFormat* formatToAdopt); /** * Allows you to set the number formatter. * @param formatToAdopt NumberFormat object to be set. - * @stable + * @stable ICU 2.0 */ virtual void setNumberFormat(const NumberFormat& newNumberFormat); /** * Returns a reference to the TimeZone used by this DateFormat's calendar. * @return the time zone associated with the calendar of DateFormat. - * @stable + * @stable ICU 2.0 */ virtual const TimeZone& getTimeZone(void) const; @@ -586,14 +586,14 @@ public: * Sets the time zone for the calendar of this DateFormat object. The caller * no longer owns the TimeZone object and should not delete it after this call. * @param zoneToAdopt the TimeZone to be adopted. - * @stable + * @stable ICU 2.0 */ virtual void adoptTimeZone(TimeZone* zoneToAdopt); /** * Sets the time zone for the calendar of this DateFormat object. * @param zone the new time zone. - * @stable + * @stable ICU 2.0 */ virtual void setTimeZone(const TimeZone& zone); @@ -603,19 +603,19 @@ protected: * Default constructor. Creates a DateFormat with no Calendar or NumberFormat * associated with it. This constructor depends on the subclasses to fill in * the calendar and numberFormat fields. - * @stable + * @stable ICU 2.0 */ DateFormat(); /** * Copy constructor. - * @stable + * @stable ICU 2.0 */ DateFormat(const DateFormat&); /** * Default assignment operator. - * @stable + * @stable ICU 2.0 */ DateFormat& operator=(const DateFormat&); diff --git a/icu4c/source/i18n/unicode/dcfmtsym.h b/icu4c/source/i18n/unicode/dcfmtsym.h index c29535b47e..2953e936f5 100644 --- a/icu4c/source/i18n/unicode/dcfmtsym.h +++ b/icu4c/source/i18n/unicode/dcfmtsym.h @@ -77,7 +77,7 @@ class U_I18N_API DecimalFormatSymbols : public UObject { public: /** * Constants for specifying a number format symbol. - * @stable + * @stable ICU 2.0 */ enum ENumberFormatSymbol { /** The decimal separator */ @@ -122,7 +122,7 @@ public: * @param locale The locale to get symbols for. * @param status Input/output parameter, set to success or * failure code upon return. - * @stable + * @stable ICU 2.0 */ DecimalFormatSymbols(const Locale& locale, UErrorCode& status); @@ -134,25 +134,25 @@ public: * * @param status Input/output parameter, set to success or * failure code upon return. - * @stable + * @stable ICU 2.0 */ DecimalFormatSymbols( UErrorCode& status); /** * Copy constructor. - * @stable + * @stable ICU 2.0 */ DecimalFormatSymbols(const DecimalFormatSymbols&); /** * Assignment operator. - * @stable + * @stable ICU 2.0 */ DecimalFormatSymbols& operator=(const DecimalFormatSymbols&); /** * Destructor. - * @stable + * @stable ICU 2.0 */ ~DecimalFormatSymbols(); @@ -161,7 +161,7 @@ public: * * @param other the object to be compared with. * @return true if another object is semantically equal to this one. - * @stable + * @stable ICU 2.0 */ UBool operator==(const DecimalFormatSymbols& other) const; @@ -170,7 +170,7 @@ public: * * @param other the object to be compared with. * @return true if another object is semantically unequal to this one. - * @stable + * @stable ICU 2.0 */ UBool operator!=(const DecimalFormatSymbols& other) const { return !operator==(other); } @@ -181,7 +181,7 @@ public: * * @param symbol Constant to indicate a number format symbol. * @return the format symbols by the param 'symbol' - * @stable + * @stable ICU 2.0 */ UnicodeString getSymbol(ENumberFormatSymbol symbol) const; @@ -192,7 +192,7 @@ public: * * @param symbol Constant to indicate a number format symbol. * @param value value of the format sybmol - * @stable + * @stable ICU 2.0 */ void setSymbol(ENumberFormatSymbol symbol, UnicodeString value); diff --git a/icu4c/source/i18n/unicode/decimfmt.h b/icu4c/source/i18n/unicode/decimfmt.h index d5b7f7254a..bb78f93ca5 100644 --- a/icu4c/source/i18n/unicode/decimfmt.h +++ b/icu4c/source/i18n/unicode/decimfmt.h @@ -211,7 +211,7 @@ public: * locale. * @param status Output param set to success/failure code. If the * pattern is invalid this will be set to a failure code. - * @stable + * @stable ICU 2.0 */ DecimalFormat(UErrorCode& status); @@ -227,7 +227,7 @@ public: * @param pattern A non-localized pattern string. * @param status Output param set to success/failure code. If the * pattern is invalid this will be set to a failure code. - * @stable + * @stable ICU 2.0 */ DecimalFormat(const UnicodeString& pattern, UErrorCode& status); @@ -248,7 +248,7 @@ public: * delete this object after making this call. * @param status Output param set to success/failure code. If the * pattern is invalid this will be set to a failure code. - * @stable + * @stable ICU 2.0 */ DecimalFormat( const UnicodeString& pattern, DecimalFormatSymbols* symbolsToAdopt, @@ -292,7 +292,7 @@ public: * @param symbols the set of symbols to be used * @param status Output param set to success/failure code. If the * pattern is invalid this will be set to a failure code. - * @stable + * @stable ICU 2.0 */ DecimalFormat( const UnicodeString& pattern, const DecimalFormatSymbols& symbols, @@ -302,7 +302,7 @@ public: * Copy constructor. * * @param source the DecimalFormat object to be copied from. - * @stable + * @stable ICU 2.0 */ DecimalFormat(const DecimalFormat& source); @@ -310,13 +310,13 @@ public: * Assignment operator. * * @param rhs the DecimalFormat object to be copied. - * @stable + * @stable ICU 2.0 */ DecimalFormat& operator=(const DecimalFormat& rhs); /** * Destructor. - * @stable + * @stable ICU 2.0 */ virtual ~DecimalFormat(); @@ -325,7 +325,7 @@ public: * result and should delete it when done. * * @return a polymorphic copy of this DecimalFormat. - * @stable + * @stable ICU 2.0 */ virtual Format* clone(void) const; @@ -335,7 +335,7 @@ public: * * @param other the object to be compared with. * @return true if the given Format objects are semantically equal. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const Format& other) const; @@ -348,7 +348,7 @@ public: * @param pos On input: an alignment field, if desired. * On output: the offsets of the alignment field. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format(double number, UnicodeString& appendTo, @@ -362,7 +362,7 @@ public: * @param pos On input: an alignment field, if desired. * On output: the offsets of the alignment field. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format(int32_t number, UnicodeString& appendTo, @@ -377,7 +377,7 @@ public: * On output: the offsets of the alignment field. * @param status Error code indicating success or failure. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format(const Formattable& obj, UnicodeString& appendTo, @@ -393,7 +393,7 @@ public: * Result is appended to existing contents. * @param status Output parameter filled in with success or failure status. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ UnicodeString& format(const Formattable& obj, UnicodeString& appendTo, @@ -407,7 +407,7 @@ public: * @param appendTo Output parameter to receive result. * Result is appended to existing contents. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ UnicodeString& format(double number, UnicodeString& appendTo) const; @@ -421,7 +421,7 @@ public: * @param appendTo Output parameter to receive result. * Result is appended to existing contents. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ UnicodeString& format(int32_t number, UnicodeString& appendTo) const; @@ -443,7 +443,7 @@ public: * On output, moved to after the last successfully * parse character. On parse failure, does not change. * @see Formattable - * @stable + * @stable ICU 2.0 */ virtual void parse(const UnicodeString& text, Formattable& result, @@ -456,7 +456,7 @@ public: * @param text The text to be parsed. * @param result Formattable to be set to the parse result. * @param status Output parameter filled in with success or failure status. - * @stable + * @stable ICU 2.0 */ virtual void parse(const UnicodeString& text, Formattable& result, @@ -467,7 +467,7 @@ public: * by the programmer or user. * @return desired DecimalFormatSymbols * @see DecimalFormatSymbols - * @stable + * @stable ICU 2.0 */ virtual const DecimalFormatSymbols* getDecimalFormatSymbols(void) const; @@ -475,7 +475,7 @@ public: * Sets the decimal format symbols, which is generally not changed * by the programmer or user. * @param symbolsToAdopt DecimalFormatSymbols to be adopted. - * @stable + * @stable ICU 2.0 */ virtual void adoptDecimalFormatSymbols(DecimalFormatSymbols* symbolsToAdopt); @@ -483,7 +483,7 @@ public: * Sets the decimal format symbols, which is generally not changed * by the programmer or user. * @param symbols DecimalFormatSymbols. - * @stable + * @stable ICU 2.0 */ virtual void setDecimalFormatSymbols(const DecimalFormatSymbols& symbols); @@ -494,7 +494,7 @@ public: * @param result Output param which will receive the positive prefix. * @return A reference to 'result'. * Examples: +123, $123, sFr123 - * @stable + * @stable ICU 2.0 */ UnicodeString& getPositivePrefix(UnicodeString& result) const; @@ -503,7 +503,7 @@ public: * * @param newValue the new value of the the positive prefix to be set. * Examples: +123, $123, sFr123 - * @stable + * @stable ICU 2.0 */ virtual void setPositivePrefix(const UnicodeString& newValue); @@ -513,7 +513,7 @@ public: * @param result Output param which will receive the negative prefix. * @return A reference to 'result'. * Examples: -123, ($123) (with negative suffix), sFr-123 - * @stable + * @stable ICU 2.0 */ UnicodeString& getNegativePrefix(UnicodeString& result) const; @@ -522,7 +522,7 @@ public: * * @param newValue the new value of the the negative prefix to be set. * Examples: -123, ($123) (with negative suffix), sFr-123 - * @stable + * @stable ICU 2.0 */ virtual void setNegativePrefix(const UnicodeString& newValue); @@ -532,7 +532,7 @@ public: * @param result Output param which will receive the positive suffix. * @return A reference to 'result'. * Example: 123% - * @stable + * @stable ICU 2.0 */ UnicodeString& getPositiveSuffix(UnicodeString& result) const; @@ -541,7 +541,7 @@ public: * * @param newValue the new value of the positive suffix to be set. * Example: 123% - * @stable + * @stable ICU 2.0 */ virtual void setPositiveSuffix(const UnicodeString& newValue); @@ -551,7 +551,7 @@ public: * @param result Output param which will receive the negative suffix. * @return A reference to 'result'. * Examples: -123%, ($123) (with positive suffixes) - * @stable + * @stable ICU 2.0 */ UnicodeString& getNegativeSuffix(UnicodeString& result) const; @@ -560,7 +560,7 @@ public: * * @param newValue the new value of the negative suffix to be set. * Examples: 123% - * @stable + * @stable ICU 2.0 */ virtual void setNegativeSuffix(const UnicodeString& newValue); @@ -572,7 +572,7 @@ public: * * @return the multiplier for use in percent, permill, etc. * Examples: with 100, 1.23 -> "123", and "123" -> 1.23 - * @stable + * @stable ICU 2.0 */ int32_t getMultiplier(void) const; @@ -584,7 +584,7 @@ public: * * @param newValue the new value of the multiplier for use in percent, permill, etc. * Examples: with 100, 1.23 -> "123", and "123" -> 1.23 - * @stable + * @stable ICU 2.0 */ virtual void setMultiplier(int32_t newValue); @@ -595,7 +595,7 @@ public: * @see #setRoundingIncrement * @see #getRoundingMode * @see #setRoundingMode - * @stable + * @stable ICU 2.0 */ virtual double getRoundingIncrement(void); @@ -607,7 +607,7 @@ public: * @see #getRoundingIncrement * @see #getRoundingMode * @see #setRoundingMode - * @stable + * @stable ICU 2.0 */ virtual void setRoundingIncrement(double newValue); @@ -617,7 +617,7 @@ public: * @see #setRoundingIncrement * @see #getRoundingIncrement * @see #setRoundingMode - * @stable + * @stable ICU 2.0 */ virtual ERoundingMode getRoundingMode(void); @@ -628,7 +628,7 @@ public: * @see #setRoundingIncrement * @see #getRoundingIncrement * @see #getRoundingMode - * @stable + * @stable ICU 2.0 */ virtual void setRoundingMode(ERoundingMode roundingMode); @@ -640,7 +640,7 @@ public: * @see #setPadCharacter * @see #getPadPosition * @see #setPadPosition - * @stable + * @stable ICU 2.0 */ virtual int32_t getFormatWidth(void); @@ -655,7 +655,7 @@ public: * @see #setPadCharacter * @see #getPadPosition * @see #setPadPosition - * @stable + * @stable ICU 2.0 */ virtual void setFormatWidth(int32_t width); @@ -670,7 +670,7 @@ public: * @see #setPadCharacter * @see #getPadPosition * @see #setPadPosition - * @stable + * @stable ICU 2.0 */ virtual UnicodeString getPadCharacterString(); @@ -686,7 +686,7 @@ public: * @see #getPadCharacter * @see #getPadPosition * @see #setPadPosition - * @stable + * @stable ICU 2.0 */ virtual void setPadCharacter(UnicodeString padChar); @@ -706,7 +706,7 @@ public: * @see #kPadAfterPrefix * @see #kPadBeforeSuffix * @see #kPadAfterSuffix - * @stable + * @stable ICU 2.0 */ virtual EPadPosition getPadPosition(void); @@ -728,7 +728,7 @@ public: * @see #kPadAfterPrefix * @see #kPadBeforeSuffix * @see #kPadAfterSuffix - * @stable + * @stable ICU 2.0 */ virtual void setPadPosition(EPadPosition padPos); @@ -740,7 +740,7 @@ public: * @see #setMinimumExponentDigits * @see #isExponentSignAlwaysShown * @see #setExponentSignAlwaysShown - * @stable + * @stable ICU 2.0 */ virtual UBool isScientificNotation(void); @@ -753,7 +753,7 @@ public: * @see #setMinimumExponentDigits * @see #isExponentSignAlwaysShown * @see #setExponentSignAlwaysShown - * @stable + * @stable ICU 2.0 */ virtual void setScientificNotation(UBool useScientific); @@ -765,7 +765,7 @@ public: * @see #setMinimumExponentDigits * @see #isExponentSignAlwaysShown * @see #setExponentSignAlwaysShown - * @stable + * @stable ICU 2.0 */ virtual int8_t getMinimumExponentDigits(void); @@ -779,7 +779,7 @@ public: * @see #getMinimumExponentDigits * @see #isExponentSignAlwaysShown * @see #setExponentSignAlwaysShown - * @stable + * @stable ICU 2.0 */ virtual void setMinimumExponentDigits(int8_t minExpDig); @@ -793,7 +793,7 @@ public: * @see #setMinimumExponentDigits * @see #getMinimumExponentDigits * @see #setExponentSignAlwaysShown - * @stable + * @stable ICU 2.0 */ virtual UBool isExponentSignAlwaysShown(void); @@ -808,7 +808,7 @@ public: * @see #setMinimumExponentDigits * @see #getMinimumExponentDigits * @see #isExponentSignAlwaysShown - * @stable + * @stable ICU 2.0 */ virtual void setExponentSignAlwaysShown(UBool expSignAlways); @@ -821,7 +821,7 @@ public: * @see setGroupingSize * @see NumberFormat::isGroupingUsed * @see DecimalFormatSymbols::getGroupingSeparator - * @stable + * @stable ICU 2.0 */ int32_t getGroupingSize(void) const; @@ -834,7 +834,7 @@ public: * @see getGroupingSize * @see NumberFormat::setGroupingUsed * @see DecimalFormatSymbols::setGroupingSeparator - * @stable + * @stable ICU 2.0 */ virtual void setGroupingSize(int32_t newValue); @@ -875,7 +875,7 @@ public: * * @return TRUE if the decimal separator always appear with decimals. * Example: Decimal ON: 12345 -> 12345.; OFF: 12345 -> 12345 - * @stable + * @stable ICU 2.0 */ UBool isDecimalSeparatorAlwaysShown(void) const; @@ -885,7 +885,7 @@ public: * * @param newValue set TRUE if the decimal separator will always appear with decimals. * Example: Decimal ON: 12345 -> 12345.; OFF: 12345 -> 12345 - * @stable + * @stable ICU 2.0 */ virtual void setDecimalSeparatorAlwaysShown(UBool newValue); @@ -897,7 +897,7 @@ public: * Previous contents are deleted. * @return A reference to 'result'. * @see applyPattern - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& toPattern(UnicodeString& result) const; @@ -909,7 +909,7 @@ public: * Previous contents are deleted. * @return A reference to 'result'. * @see applyPattern - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& toLocalizedPattern(UnicodeString& result) const; @@ -951,7 +951,7 @@ public: * @param status Output param set to success/failure code on * exit. If the pattern is invalid, this will be * set to a failure result. - * @stable + * @stable ICU 2.0 */ virtual void applyPattern(const UnicodeString& pattern, UErrorCode& status); @@ -997,7 +997,7 @@ public: * @param status Output param set to success/failure code on * exit. If the pattern is invalid, this will be * set to a failure result. - * @stable + * @stable ICU 2.0 */ virtual void applyLocalizedPattern(const UnicodeString& pattern, UErrorCode& status); @@ -1010,7 +1010,7 @@ public: * @param newValue the new value of the maximum number of digits * allowed in the integer portion of a number. * @see NumberFormat#setMaximumIntegerDigits - * @stable + * @stable ICU 2.0 */ virtual void setMaximumIntegerDigits(int32_t newValue); @@ -1021,7 +1021,7 @@ public: * @param newValue the new value of the minimum number of digits * allowed in the integer portion of a number. * @see NumberFormat#setMinimumIntegerDigits - * @stable + * @stable ICU 2.0 */ virtual void setMinimumIntegerDigits(int32_t newValue); @@ -1032,7 +1032,7 @@ public: * @param newValue the new value of the maximum number of digits * allowed in the fraction portion of a number. * @see NumberFormat#setMaximumFractionDigits - * @stable + * @stable ICU 2.0 */ virtual void setMaximumFractionDigits(int32_t newValue); @@ -1043,7 +1043,7 @@ public: * @param newValue the new value of the minimum number of digits * allowed in the fraction portion of a number. * @see NumberFormat#setMinimumFractionDigits - * @stable + * @stable ICU 2.0 */ virtual void setMinimumFractionDigits(int32_t newValue); @@ -1076,7 +1076,7 @@ public: /** * The resource tags we use to retrieve decimal format data from * locale resource bundles. - * @stable + * @stable ICU 2.0 */ static const char fgNumberPatterns[]; @@ -1091,7 +1091,7 @@ public: * . Derived::getStaticClassID()) ... * * @return The class ID for all objects of this class. - * @stable + * @stable ICU 2.0 */ static UClassID getStaticClassID(void) { return (UClassID)&fgClassID; } @@ -1104,7 +1104,7 @@ public: * @return The class ID for this object. All objects of a * given class have the same class ID. Objects of * other classes have different class IDs. - * @stable + * @stable ICU 2.0 */ virtual UClassID getDynamicClassID(void) const { return getStaticClassID(); } diff --git a/icu4c/source/i18n/unicode/dtfmtsym.h b/icu4c/source/i18n/unicode/dtfmtsym.h index 8d78b47865..6f9bb38d97 100644 --- a/icu4c/source/i18n/unicode/dtfmtsym.h +++ b/icu4c/source/i18n/unicode/dtfmtsym.h @@ -74,7 +74,7 @@ public: * @param status Output param set to success of failure. Failure * results if the resources for the default cannot be * found or cannot be loaded - * @stable + * @stable ICU 2.0 */ DateFormatSymbols(UErrorCode& status); @@ -86,27 +86,27 @@ public: * @param status Output param set to success of failure. Failure * results if the resources for the locale cannot be * found or cannot be loaded - * @stable + * @stable ICU 2.0 */ DateFormatSymbols(const Locale& locale, UErrorCode& status); /** * Copy constructor. - * @stable + * @stable ICU 2.0 */ DateFormatSymbols(const DateFormatSymbols&); /** * Assignment operator. - * @stable + * @stable ICU 2.0 */ DateFormatSymbols& operator=(const DateFormatSymbols&); /** * Destructor. This is nonvirtual because this class is not designed to be * subclassed. - * @stable + * @stable ICU 2.0 */ ~DateFormatSymbols(); @@ -115,7 +115,7 @@ public: * * @param other the DateFormatSymbols object to be compared with. * @return true if other is semantically equal to this. - * @stable + * @stable ICU 2.0 */ UBool operator==(const DateFormatSymbols& other) const; @@ -124,7 +124,7 @@ public: * * @param other the DateFormatSymbols object to be compared with. * @return true if other is semantically unequal to this. - * @stable + * @stable ICU 2.0 */ UBool operator!=(const DateFormatSymbols& other) const { return !operator==(other); } @@ -133,7 +133,7 @@ public: * * @param count Filled in with length of the array. * @return the era strings. - * @stable + * @stable ICU 2.0 */ const UnicodeString* getEras(int32_t& count) const; @@ -141,7 +141,7 @@ public: * Sets era strings. For example: "AD" and "BC". * @param eras Array of era strings (DateFormatSymbols retains ownership.) * @param count Filled in with length of the array. - * @stable + * @stable ICU 2.0 */ void setEras(const UnicodeString* eras, int32_t count); @@ -149,7 +149,7 @@ public: * Gets month strings. For example: "January", "February", etc. * @param count Filled in with length of the array. * @return the month strings. (DateFormatSymbols retains ownership.) - * @stable + * @stable ICU 2.0 */ const UnicodeString* getMonths(int32_t& count) const; @@ -158,7 +158,7 @@ public: * * @param months the new month strings. (not adopted; caller retains ownership) * @param count Filled in with length of the array. - * @stable + * @stable ICU 2.0 */ void setMonths(const UnicodeString* months, int32_t count); @@ -167,7 +167,7 @@ public: * * @param count Filled in with length of the array. * @return the short month strings. (DateFormatSymbols retains ownership.) - * @stable + * @stable ICU 2.0 */ const UnicodeString* getShortMonths(int32_t& count) const; @@ -175,7 +175,7 @@ public: * Sets short month strings. For example: "Jan", "Feb", etc. * @param count Filled in with length of the array. * @param shortMonths the new short month strings. (not adopted; caller retains ownership) - * @stable + * @stable ICU 2.0 */ void setShortMonths(const UnicodeString* shortMonths, int32_t count); @@ -183,7 +183,7 @@ public: * Gets weekday strings. For example: "Sunday", "Monday", etc. * @param count Filled in with length of the array. * @return the weekday strings. (DateFormatSymbols retains ownership.) - * @stable + * @stable ICU 2.0 */ const UnicodeString* getWeekdays(int32_t& count) const; @@ -191,7 +191,7 @@ public: * Sets weekday strings. For example: "Sunday", "Monday", etc. * @param weekdays the new weekday strings. (not adopted; caller retains ownership) * @param count Filled in with length of the array. - * @stable + * @stable ICU 2.0 */ void setWeekdays(const UnicodeString* weekdays, int32_t count); @@ -199,7 +199,7 @@ public: * Gets short weekday strings. For example: "Sun", "Mon", etc. * @param count Filled in with length of the array. * @return the short weekday strings. (DateFormatSymbols retains ownership.) - * @stable + * @stable ICU 2.0 */ const UnicodeString* getShortWeekdays(int32_t& count) const; @@ -207,7 +207,7 @@ public: * Sets short weekday strings. For example: "Sun", "Mon", etc. * @param shortWeekdays the new short weekday strings. (not adopted; caller retains ownership) * @param count Filled in with length of the array. - * @stable + * @stable ICU 2.0 */ void setShortWeekdays(const UnicodeString* shortWeekdays, int32_t count); @@ -215,7 +215,7 @@ public: * Gets AM/PM strings. For example: "AM" and "PM". * @param count Filled in with length of the array. * @return the weekday strings. (DateFormatSymbols retains ownership.) - * @stable + * @stable ICU 2.0 */ const UnicodeString* getAmPmStrings(int32_t& count) const; @@ -223,7 +223,7 @@ public: * Sets ampm strings. For example: "AM" and "PM". * @param ampms the new ampm strings. (not adopted; caller retains ownership) * @param count Filled in with length of the array. - * @stable + * @stable ICU 2.0 */ void setAmPmStrings(const UnicodeString* ampms, int32_t count); @@ -232,7 +232,7 @@ public: * @param rowCount Output param to receive number of rows. * @param columnCount Output param to receive number of columns. * @return The timezone strings as a 2-d array. (DateFormatSymbols retains ownership.) - * @stable + * @stable ICU 2.0 */ const UnicodeString** getZoneStrings(int32_t& rowCount, int32_t& columnCount) const; @@ -241,7 +241,7 @@ public: * @param strings The timezone strings as a 2-d array to be copied. (not adopted; caller retains ownership) * @param rowCount The number of rows (count of first index). * @param columnCount The number of columns (count of second index). - * @stable + * @stable ICU 2.0 */ void setZoneStrings(const UnicodeString* const* strings, int32_t rowCount, int32_t columnCount); @@ -256,7 +256,7 @@ public: /** * Get the non-localized date-time pattern characters. * @return the non-localized date-time pattern characters - * @stable + * @stable ICU 2.0 */ static const UChar *getPatternUChars(void); @@ -264,7 +264,7 @@ public: * Gets localized date-time pattern characters. For example: 'u', 't', etc. * @param result Output param which will receive the localized date-time pattern characters. * @return A reference to 'result'. - * @stable + * @stable ICU 2.0 */ UnicodeString& getLocalPatternChars(UnicodeString& result) const; @@ -272,7 +272,7 @@ public: * Sets localized date-time pattern characters. For example: 'u', 't', etc. * @param newLocalPatternChars the new localized date-time * pattern characters. - * @stable + * @stable ICU 2.0 */ void setLocalPatternChars(const UnicodeString& newLocalPatternChars); diff --git a/icu4c/source/i18n/unicode/fieldpos.h b/icu4c/source/i18n/unicode/fieldpos.h index 2921201e21..b9f0dc4fae 100644 --- a/icu4c/source/i18n/unicode/fieldpos.h +++ b/icu4c/source/i18n/unicode/fieldpos.h @@ -105,7 +105,7 @@ public: /** * Creates a FieldPosition object with a non-specified field. - * @stable + * @stable ICU 2.0 */ FieldPosition() : UObject(), fField(DONT_CARE), fBeginIndex(0), fEndIndex(0) {} @@ -119,7 +119,7 @@ public: * @see NumberFormat#FRACTION_FIELD * @see DateFormat#YEAR_FIELD * @see DateFormat#MONTH_FIELD - * @stable + * @stable ICU 2.0 */ FieldPosition(int32_t field) : UObject(), fField(field), fBeginIndex(0), fEndIndex(0) {} @@ -127,21 +127,21 @@ public: /** * Copy constructor * @param copy the object to be copied from. - * @stable + * @stable ICU 2.0 */ FieldPosition(const FieldPosition& copy) : UObject(copy), fField(copy.fField), fBeginIndex(copy.fBeginIndex), fEndIndex(copy.fEndIndex) {} /** * Destructor - * @stable + * @stable ICU 2.0 */ ~FieldPosition() {} /** * Assignment operator * @param copy the object to be copied from. - * @stable + * @stable ICU 2.0 */ FieldPosition& operator=(const FieldPosition& copy); @@ -149,7 +149,7 @@ public: * Equality operator. * @param that the object to be compared with. * @return TRUE if the two field positions are equal, FALSE otherwise. - * @stable + * @stable ICU 2.0 */ UBool operator==(const FieldPosition& that) const; @@ -157,21 +157,21 @@ public: * Equality operator. * @param that the object to be compared with. * @return TRUE if the two field positions are not equal, FALSE otherwise. - * @stable + * @stable ICU 2.0 */ UBool operator!=(const FieldPosition& that) const; /** * Retrieve the field identifier. * @return the field identifier. - * @stable + * @stable ICU 2.0 */ int32_t getField(void) const { return fField; } /** * Retrieve the index of the first character in the requested field. * @return the index of the first character in the requested field. - * @stable + * @stable ICU 2.0 */ int32_t getBeginIndex(void) const { return fBeginIndex; } @@ -180,28 +180,28 @@ public: * requested field. * @return the index of the character following the last character in the * requested field. - * @stable + * @stable ICU 2.0 */ int32_t getEndIndex(void) const { return fEndIndex; } /** * Set the field. * @param f the new value of the field. - * @stable + * @stable ICU 2.0 */ void setField(int32_t f) { fField = f; } /** * Set the begin index. For use by subclasses of Format. * @param bi the new value of the begin index - * @stable + * @stable ICU 2.0 */ void setBeginIndex(int32_t bi) { fBeginIndex = bi; } /** * Set the end index. For use by subclasses of Format. * @param ei the new value of the end index - * @stable + * @stable ICU 2.0 */ void setEndIndex(int32_t ei) { fEndIndex = ei; } diff --git a/icu4c/source/i18n/unicode/fmtable.h b/icu4c/source/i18n/unicode/fmtable.h index 693924817b..ac138714b7 100644 --- a/icu4c/source/i18n/unicode/fmtable.h +++ b/icu4c/source/i18n/unicode/fmtable.h @@ -64,57 +64,57 @@ public: /** * Creates a Formattable object with a double number. * @param d the double number. - * @stable + * @stable ICU 2.0 */ Formattable(double d); /** * Creates a Formattable object with a long number. * @param d the long number. - * @stable + * @stable ICU 2.0 */ Formattable(int32_t l); /** * Creates a Formattable object with a char string pointer. * Assumes that the char string is null terminated. * @param strToCopy the char string. - * @stable + * @stable ICU 2.0 */ Formattable(const char* strToCopy); /** * Creates a Formattable object with a UnicodeString object to copy from. * @param strToCopy the UnicodeString string. - * @stable + * @stable ICU 2.0 */ Formattable(const UnicodeString& stringToCopy); /** * Creates a Formattable object with a UnicodeString object to adopt from. * @param strToAdopt the UnicodeString string. - * @stable + * @stable ICU 2.0 */ Formattable(UnicodeString* stringToAdopt); /** * Creates a Formattable object with an array of Formattable objects. * @param arrayToCopy the Formattable object array. * @param count the array count. - * @stable + * @stable ICU 2.0 */ Formattable(const Formattable* arrayToCopy, int32_t count); /** * Copy constructor. - * @stable + * @stable ICU 2.0 */ Formattable(const Formattable&); /** * Assignment operator. - * @stable + * @stable ICU 2.0 */ Formattable& operator=(const Formattable&); /** * Equality comparison. * @param other the object to be compared with. * @return TRUE if other are equal to this, FALSE otherwise. - * @stable + * @stable ICU 2.0 */ UBool operator==(const Formattable&) const; @@ -122,14 +122,14 @@ public: * Equality operator. * @param other the object to be compared with. * @return TRUE if other are unequal to this, FALSE otherwise. - * @stable + * @stable ICU 2.0 */ UBool operator!=(const Formattable& other) const { return !operator==(other); } /** * Destructor. - * @stable + * @stable ICU 2.0 */ virtual ~Formattable(); @@ -147,26 +147,26 @@ public: /** * Gets the data type of this Formattable object. * @return the data type of this Formattable object. - * @stable + * @stable ICU 2.0 */ Type getType(void) const; /** * Gets the double value of this object. * @return the double value of this object. - * @stable + * @stable ICU 2.0 */ double getDouble(void) const { return fValue.fDouble; } /** * Gets the long value of this object. * @return the long value of this object. - * @stable + * @stable ICU 2.0 */ int32_t getLong(void) const { return fValue.fLong; } /** * Gets the Date value of this object. * @return the Date value of this object. - * @stable + * @stable ICU 2.0 */ UDate getDate(void) const { return fValue.fDate; } @@ -174,7 +174,7 @@ public: * Gets the string value of this object. * @param result Output param to receive the Date value of this object. * @return A reference to 'result'. - * @stable + * @stable ICU 2.0 */ UnicodeString& getString(UnicodeString& result) const { result=*fValue.fString; return result; } @@ -182,14 +182,14 @@ public: /** * Gets a const reference to the string value of this object. * @return a const reference to the string value of this object. - * @stable + * @stable ICU 2.0 */ inline const UnicodeString& getString(void) const; /** * Gets a reference to the string value of this object. * @return a reference to the string value of this object. - * @stable + * @stable ICU 2.0 */ inline UnicodeString& getString(void); @@ -197,7 +197,7 @@ public: * Gets the array value and count of this object. * @param count fill-in with the count of this object. * @return the array value of this object. - * @stable + * @stable ICU 2.0 */ const Formattable* getArray(int32_t& count) const { count=fValue.fArrayAndCount.fCount; return fValue.fArrayAndCount.fArray; } @@ -206,50 +206,50 @@ public: * Accesses the specified element in the array value of this Formattable object. * @param index the specified index. * @return the accessed element in the array. - * @stable + * @stable ICU 2.0 */ Formattable& operator[](int32_t index) { return fValue.fArrayAndCount.fArray[index]; } /** * Sets the double value of this object. * @param d the new double value to be set. - * @stable + * @stable ICU 2.0 */ void setDouble(double d); /** * Sets the long value of this object. * @param l the new long value to be set. - * @stable + * @stable ICU 2.0 */ void setLong(int32_t l); /** * Sets the Date value of this object. * @param d the new Date value to be set. - * @stable + * @stable ICU 2.0 */ void setDate(UDate d); /** * Sets the string value of this object. * @param stringToCopy the new string value to be set. - * @stable + * @stable ICU 2.0 */ void setString(const UnicodeString& stringToCopy); /** * Sets the array value and count of this object. * @param array the array value. * @param count the number of array elements to be copied. - * @stable + * @stable ICU 2.0 */ void setArray(const Formattable* array, int32_t count); /** * Sets and adopts the string value and count of this object. * @param stringToAdopt the new string value to be adopted. - * @stable + * @stable ICU 2.0 */ void adoptString(UnicodeString* stringToAdopt); /** * Sets and adopts the array value and count of this object. - * @stable + * @stable ICU 2.0 */ void adoptArray(Formattable* array, int32_t count); diff --git a/icu4c/source/i18n/unicode/format.h b/icu4c/source/i18n/unicode/format.h index 13b0cf95b1..d9a84fd287 100644 --- a/icu4c/source/i18n/unicode/format.h +++ b/icu4c/source/i18n/unicode/format.h @@ -98,7 +98,7 @@ public: * @param other the object to be compared with. * @return Return true if the given Format objects are semantically equal. * Objects of different subclasses are considered unequal. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const Format& other) const = 0; @@ -107,7 +107,7 @@ public: * equal. * @param other the object to be compared with. * @return Return true if the given Format objects are not semantically. - * @stable + * @stable ICU 2.0 */ UBool operator!=(const Format& other) const { return !operator==(other); } @@ -115,7 +115,7 @@ public: * Clone this object polymorphically. The caller is responsible * for deleting the result when done. * @return A copy of the object - * @stable + * @stable ICU 2.0 */ virtual Format* clone() const = 0; @@ -127,7 +127,7 @@ public: * Result is appended to existing contents. * @param status Output parameter filled in with success or failure status. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ UnicodeString& format(const Formattable& obj, UnicodeString& appendTo, @@ -147,7 +147,7 @@ public: * On output: the offsets of the alignment field. * @param status Output param filled with success/failure status. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format(const Formattable& obj, UnicodeString& appendTo, @@ -191,7 +191,7 @@ public: * last character successfully parsed. If the * source is not parsed successfully, this param * will remain unchanged. - * @stable + * @stable ICU 2.0 */ virtual void parseObject(const UnicodeString& source, Formattable& result, @@ -207,7 +207,7 @@ public: * If parse fails, return contents are undefined. * @param status Output param to be filled with success/failure * result code. - * @stable + * @stable ICU 2.0 */ void parseObject(const UnicodeString& source, Formattable& result, @@ -228,24 +228,24 @@ public: * @return The class ID for this object. All objects of a * given class have the same class ID. Objects of * other classes have different class IDs. - * @stable + * @stable ICU 2.0 */ virtual UClassID getDynamicClassID() const = 0; protected: /** * Default constructor for subclass use only. Does nothing. - * @stable + * @stable ICU 2.0 */ Format(); /** - * @stable + * @stable ICU 2.0 */ Format(const Format&); // Does nothing; for subclasses only /** - * @stable + * @stable ICU 2.0 */ Format& operator=(const Format&); // Does nothing; for subclasses diff --git a/icu4c/source/i18n/unicode/gregocal.h b/icu4c/source/i18n/unicode/gregocal.h index 55ffc0dc0f..39fe0895a0 100644 --- a/icu4c/source/i18n/unicode/gregocal.h +++ b/icu4c/source/i18n/unicode/gregocal.h @@ -134,14 +134,14 @@ U_NAMESPACE_BEGIN * delete calendar; // also deletes pdt * \endcode * - * @stable + * @stable ICU 2.0 */ class U_I18N_API GregorianCalendar: public Calendar { public: /** * Useful constants for GregorianCalendar and TimeZone. - * @stable + * @stable ICU 2.0 */ enum EEras { BC, @@ -154,7 +154,7 @@ public: * * @param success Indicates the status of GregorianCalendar object construction. * Returns U_ZERO_ERROR if constructed successfully. - * @stable + * @stable ICU 2.0 */ GregorianCalendar(UErrorCode& success); @@ -166,7 +166,7 @@ public: * @param zoneToAdopt The given timezone. * @param success Indicates the status of GregorianCalendar object construction. * Returns U_ZERO_ERROR if constructed successfully. - * @stable + * @stable ICU 2.0 */ GregorianCalendar(TimeZone* zoneToAdopt, UErrorCode& success); @@ -177,7 +177,7 @@ public: * @param zone The given timezone. * @param success Indicates the status of GregorianCalendar object construction. * Returns U_ZERO_ERROR if constructed successfully. - * @stable + * @stable ICU 2.0 */ GregorianCalendar(const TimeZone& zone, UErrorCode& success); @@ -188,7 +188,7 @@ public: * @param aLocale The given locale. * @param success Indicates the status of GregorianCalendar object construction. * Returns U_ZERO_ERROR if constructed successfully. - * @stable + * @stable ICU 2.0 */ GregorianCalendar(const Locale& aLocale, UErrorCode& success); @@ -201,7 +201,7 @@ public: * @param aLocale The given locale. * @param success Indicates the status of GregorianCalendar object construction. * Returns U_ZERO_ERROR if constructed successfully. - * @stable + * @stable ICU 2.0 */ GregorianCalendar(TimeZone* zoneToAdopt, const Locale& aLocale, UErrorCode& success); @@ -213,7 +213,7 @@ public: * @param aLocale The given locale. * @param success Indicates the status of GregorianCalendar object construction. * Returns U_ZERO_ERROR if constructed successfully. - * @stable + * @stable ICU 2.0 */ GregorianCalendar(const TimeZone& zone, const Locale& aLocale, UErrorCode& success); @@ -227,7 +227,7 @@ public: * @param date The value used to set the DATE time field in the calendar. * @param success Indicates the status of GregorianCalendar object construction. * Returns U_ZERO_ERROR if constructed successfully. - * @stable + * @stable ICU 2.0 */ GregorianCalendar(int32_t year, int32_t month, int32_t date, UErrorCode& success); @@ -243,7 +243,7 @@ public: * @param minute The value used to set the MINUTE time field in the calendar. * @param success Indicates the status of GregorianCalendar object construction. * Returns U_ZERO_ERROR if constructed successfully. - * @stable + * @stable ICU 2.0 */ GregorianCalendar(int32_t year, int32_t month, int32_t date, int32_t hour, int32_t minute, UErrorCode& success); @@ -260,34 +260,34 @@ public: * @param second The value used to set the SECOND time field in the calendar. * @param success Indicates the status of GregorianCalendar object construction. * Returns U_ZERO_ERROR if constructed successfully. - * @stable + * @stable ICU 2.0 */ GregorianCalendar(int32_t year, int32_t month, int32_t date, int32_t hour, int32_t minute, int32_t second, UErrorCode& success); /** * Destructor - * @stable + * @stable ICU 2.0 */ virtual ~GregorianCalendar(); /** * Copy constructor * @param source the object to be copied. - * @stable + * @stable ICU 2.0 */ GregorianCalendar(const GregorianCalendar& source); /** * Default assignment operator * @param right the object to be copied. - * @stable + * @stable ICU 2.0 */ GregorianCalendar& operator=(const GregorianCalendar& right); /** * Create and return a polymorphic copy of this calendar. * @return return a polymorphic copy of this calendar. - * @stable + * @stable ICU 2.0 */ virtual Calendar* clone(void) const; @@ -298,7 +298,7 @@ public: * * @param date The given Gregorian cutover date. * @param success Output param set to success/failure code on exit. - * @stable + * @stable ICU 2.0 */ void setGregorianChange(UDate date, UErrorCode& success); @@ -308,7 +308,7 @@ public: * 15, 1582. Previous to this time and date will be Julian dates. * * @return The Gregorian cutover time for this calendar. - * @stable + * @stable ICU 2.0 */ UDate getGregorianChange(void) const; @@ -325,7 +325,7 @@ public: * * @param year The given year. * @return True if the given year is a leap year; false otherwise. - * @stable + * @stable ICU 2.0 */ UBool isLeapYear(int32_t year) const; @@ -348,7 +348,7 @@ public: * @param status Output param set to success/failure code on exit. If any value * previously set in the time field is invalid, this will be set to * an error status. - * @stable + * @stable ICU 2.0 */ virtual void add(EDateFields field, int32_t amount, UErrorCode& status); @@ -361,7 +361,7 @@ public: * @param status Output param set to success/failure code on exit. If any value * previously set in the time field is invalid, this will be set to * an error status. - * @stable + * @stable ICU 2.0 */ virtual void roll(EDateFields field, int32_t amount, UErrorCode& status); @@ -370,7 +370,7 @@ public: * Gregorian DAY_OF_MONTH, 1. * @param field the time field. * @return minimum value for the given field - * @stable + * @stable ICU 2.0 */ virtual int32_t getMinimum(EDateFields field) const; @@ -379,7 +379,7 @@ public: * Gregorian DAY_OF_MONTH, 31. * @param field the time field. * @return maximum value for the given field - * @stable + * @stable ICU 2.0 */ virtual int32_t getMaximum(EDateFields field) const; @@ -389,7 +389,7 @@ public: * @param field the time field. * @return highest minimum value for the given field if varies. * Otherwise same as getMinimum(). - * @stable + * @stable ICU 2.0 */ virtual int32_t getGreatestMinimum(EDateFields field) const; @@ -399,7 +399,7 @@ public: * @param field the time field. * @return lowest maximum value for the given field if varies. * Otherwise same as getMaximum(). - * @stable + * @stable ICU 2.0 */ virtual int32_t getLeastMaximum(EDateFields field) const; @@ -408,7 +408,7 @@ public: * For the Gregorian calendar, this is the same as getMinimum() and getGreatestMinimum(). * @param field the time field. * @return the minimum value that this field could have, given the current date. - * @stable + * @stable ICU 2.0 */ int32_t getActualMinimum(EDateFields field) const; @@ -419,7 +419,7 @@ public: * for some years the actual maximum for MONTH is 12, and for others 13. * @param field the time field. * @return the maximum value that this field could have, given the current date. - * @stable + * @stable ICU 2.0 */ int32_t getActualMaximum(EDateFields field) const; @@ -430,7 +430,7 @@ public: * @param status Fill-in parameter which receives the status of this operation. * @return True if the current date for this Calendar is in Daylight Savings Time, * false, otherwise. - * @stable + * @stable ICU 2.0 */ virtual UBool inDaylightTime(UErrorCode& status) const; @@ -444,7 +444,7 @@ public: * * @return The class ID for this object. All objects of a given class have the * same class ID. Objects of other classes have different class IDs. - * @stable + * @stable ICU 2.0 */ virtual UClassID getDynamicClassID(void) const { return (UClassID)&fgClassID; } @@ -457,7 +457,7 @@ public: * Derived::getStaticClassID()) ... * * @return The class ID for all objects of this class. - * @stable + * @stable ICU 2.0 */ static UClassID getStaticClassID(void) { return (UClassID)&fgClassID; } @@ -466,7 +466,7 @@ protected: /** * (Overrides Calendar) Converts GMT as milliseconds to time field values. * @param status Fill-in parameter which receives the status of this operation. - * @stable + * @stable ICU 2.0 */ virtual void computeFields(UErrorCode& status); @@ -477,7 +477,7 @@ protected: * @param status Output param set to success/failure code on exit. If any value * previously set in the time field is invalid, this will be set to * an error status. - * @stable + * @stable ICU 2.0 */ virtual void computeTime(UErrorCode& status); diff --git a/icu4c/source/i18n/unicode/msgfmt.h b/icu4c/source/i18n/unicode/msgfmt.h index 75a1e5c45f..17672f87f4 100644 --- a/icu4c/source/i18n/unicode/msgfmt.h +++ b/icu4c/source/i18n/unicode/msgfmt.h @@ -204,7 +204,7 @@ public: * @param pattern Pattern used to construct object. * @param status Output param to receive success code. If the * pattern cannot be parsed, set to failure code. - * @stable + * @stable ICU 2.0 */ MessageFormat(const UnicodeString& pattern, UErrorCode &status); @@ -215,7 +215,7 @@ public: * @param newLocale The locale to use for formatting dates and numbers. * @param status Output param to receive success code. If the * pattern cannot be parsed, set to failure code. - * @stable + * @stable ICU 2.0 */ MessageFormat(const UnicodeString& pattern, const Locale& newLocale, @@ -228,7 +228,7 @@ public: * of error if an error is encountered * @param success Output param to receive success code. If the * pattern cannot be parsed, set to failure code. - * @stable + * @stable ICU 2.0 */ MessageFormat(const UnicodeString& pattern, const Locale& newLocale, @@ -236,26 +236,26 @@ public: UErrorCode& success); /** * Copy constructor. - * @stable + * @stable ICU 2.0 */ MessageFormat(const MessageFormat&); /** * Assignment operator. - * @stable + * @stable ICU 2.0 */ const MessageFormat& operator=(const MessageFormat&); /** * Destructor. - * @stable + * @stable ICU 2.0 */ virtual ~MessageFormat(); /** * Clone this Format object polymorphically. The caller owns the * result and should delete it when done. - * @stable + * @stable ICU 2.0 */ virtual Format* clone(void) const; @@ -264,7 +264,7 @@ public: * Objects of different subclasses are considered unequal. * @param other the object to be compared with. * @return true if the given Format objects are semantically equal. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const Format& other) const; @@ -272,7 +272,7 @@ public: * Sets the locale. This locale is used for fetching default number or date * format information. * @param theLocale the new locale value to be set. - * @stable + * @stable ICU 2.0 */ virtual void setLocale(const Locale& theLocale); @@ -280,7 +280,7 @@ public: * Gets the locale. This locale is used for fetching default number or date * format information. * @return the locale of the object. - * @stable + * @stable ICU 2.0 */ virtual const Locale& getLocale(void) const; @@ -291,7 +291,7 @@ public: * @param status Output param set to success/failure code on * exit. If the pattern is invalid, this will be * set to a failure result. - * @stable + * @stable ICU 2.0 */ virtual void applyPattern(const UnicodeString& pattern, UErrorCode& status); @@ -314,7 +314,7 @@ public: * @param appendTo Output parameter to receive the pattern. * Result is appended to existing contents. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& toPattern(UnicodeString& appendTo) const; @@ -326,7 +326,7 @@ public: * ownership is retained by the caller. If the count is over * the maximum allowed (10), any additional items will be deleted. * - * @stable + * @stable ICU 2.0 * @param formatsToAdopt the format to be adopted. * @param count the size of the array. */ @@ -339,7 +339,7 @@ public: * If the count is over the maximum allowed (10), any additional * items will be ignored. * - * @stable + * @stable ICU 2.0 * @param newFormats the new format to be set. * @param cnt the size of the array. */ @@ -352,7 +352,7 @@ public: * The caller should not delete the Format object after this call. * If the number is over the number of formats already set, * the item will be deleted and ignored. - * @stable + * @stable ICU 2.0 * @param formatNumber index of the parameter. * @param formatToAdopt the format to be adopted. */ @@ -365,14 +365,14 @@ public: * the item will be ignored. * @param variable index of the parameter. * @param newFormat the format to be set. - * @stable + * @stable ICU 2.0 */ virtual void setFormat(int32_t variable, const Format& newFormat); /** * Gets formats that were set with setFormats. * See the class description about format numbering. - * @stable + * @stable ICU 2.0 * @param count the size of the array. */ virtual const Format** getFormats(int32_t& count) const; @@ -389,7 +389,7 @@ public: * @param ignore No useful status is returned. * @param success Output param set to success/failure code * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ UnicodeString& format( const Formattable* source, int32_t count, @@ -407,7 +407,7 @@ public: * Result is appended to existing contents. * @param success Output param set to success/failure code * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ static UnicodeString& format( const UnicodeString& pattern, const Formattable* arguments, @@ -428,7 +428,7 @@ public: * On output: the offsets of the alignment field. * @param status Output param filled with success/failure status. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format(const Formattable& obj, UnicodeString& appendTo, @@ -442,7 +442,7 @@ public: * Result is appended to existing contents. * @param status Output param filled with success/failure status. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ UnicodeString& format(const Formattable& obj, UnicodeString& appendTo, @@ -474,7 +474,7 @@ public: * @param source String to be parsed. * @param status On input, starting position for parse. On output, * final position after parse. - * @stable + * @stable ICU 2.0 */ virtual Formattable* parse( const UnicodeString& source, ParsePosition& status, @@ -487,7 +487,7 @@ public: * @param source String to be parsed. * @param count Output param to receive size of returned array. * @param status Output param to receive success/error code. - * @stable + * @stable ICU 2.0 */ virtual Formattable* parse( const UnicodeString& source, int32_t& count, @@ -520,7 +520,7 @@ public: * @return A newly created Formattable* object, or NULL * on failure. The caller owns this and should * delete it when done. - * @stable + * @stable ICU 2.0 */ virtual void parseObject(const UnicodeString& source, Formattable& result, @@ -536,7 +536,7 @@ public: * @return The class ID for this object. All objects of a * given class have the same class ID. Objects of * other classes have different class IDs. - * @stable + * @stable ICU 2.0 */ virtual UClassID getDynamicClassID(void) const; @@ -549,7 +549,7 @@ public: * . Derived::getStaticClassID()) ... * * @return The class ID for all objects of this class. - * @stable + * @stable ICU 2.0 */ static UClassID getStaticClassID(void) { return (UClassID)&fgClassID; } diff --git a/icu4c/source/i18n/unicode/numfmt.h b/icu4c/source/i18n/unicode/numfmt.h index 8b8d4835ed..f799d669a8 100644 --- a/icu4c/source/i18n/unicode/numfmt.h +++ b/icu4c/source/i18n/unicode/numfmt.h @@ -123,7 +123,7 @@ class Locale; * widthToAlignmentPoint) before drawing the text. It also works * where there is no decimal, but possibly additional characters at * the end, e.g. with parentheses in negative numbers: "(12)" for -12. - * @stable + * @stable ICU 2.0 */ class U_I18N_API NumberFormat : public Format { public: @@ -134,7 +134,7 @@ public: * a formatted number should be returned. * * @see FieldPosition - * @stable + * @stable ICU 2.0 */ enum EAlignmentFields { kIntegerField, @@ -144,7 +144,7 @@ public: /** * These constants are provided for backwards compatibility only, * and are deprecated. Please use the C++ style constants defined above. - * @stable + * @stable ICU 2.0 */ INTEGER_FIELD = kIntegerField, FRACTION_FIELD = kFractionField @@ -152,7 +152,7 @@ public: /** * Destructor. - * @stable + * @stable ICU 2.0 */ virtual ~NumberFormat(); @@ -160,7 +160,7 @@ public: * Return true if the given Format objects are semantically equal. * Objects of different subclasses are considered unequal. * @return true if the given Format objects are semantically equal. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const Format& other) const; @@ -177,7 +177,7 @@ public: * On output: the offsets of the alignment field. * @param status Output param filled with success/failure status. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format(const Formattable& obj, UnicodeString& appendTo, @@ -210,7 +210,7 @@ public: * @return A newly created Formattable* object, or NULL * on failure. The caller owns this and should * delete it when done. - * @stable + * @stable ICU 2.0 */ virtual void parseObject(const UnicodeString& source, Formattable& result, @@ -224,7 +224,7 @@ public: * @param appendTo Output parameter to receive result. * Result is appended to existing contents. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ UnicodeString& format( double number, UnicodeString& appendTo) const; @@ -237,7 +237,7 @@ public: * @param appendTo Output parameter to receive result. * Result is appended to existing contents. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ UnicodeString& format( int32_t number, UnicodeString& appendTo) const; @@ -252,7 +252,7 @@ public: * @param pos On input: an alignment field, if desired. * On output: the offsets of the alignment field. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format(double number, UnicodeString& appendTo, @@ -267,7 +267,7 @@ public: * @param pos On input: an alignment field, if desired. * On output: the offsets of the alignment field. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format(int32_t number, UnicodeString& appendTo, @@ -279,7 +279,7 @@ public: * @param appendTo Output parameter to receive result. * Result is appended to existing contents. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ UnicodeString& format(const Formattable& obj, UnicodeString& appendTo, @@ -304,7 +304,7 @@ public: * parse character. On parse failure, does not change. * @return A Formattable object of numeric type. The caller * owns this an must delete it. NULL on failure. - * @stable + * @stable ICU 2.0 */ virtual void parse(const UnicodeString& text, Formattable& result, @@ -322,7 +322,7 @@ public: * @return A Formattable object of numeric type. The caller * owns this an must delete it. NULL on failure. * @see NumberFormat::isParseIntegerOnly - * @stable + * @stable ICU 2.0 */ virtual void parse( const UnicodeString& text, Formattable& result, @@ -337,7 +337,7 @@ public: * dependant and determined by sub-classes of NumberFormat. * @return true if this format will parse numbers as integers * only. - * @stable + * @stable ICU 2.0 */ UBool isParseIntegerOnly(void) const; @@ -346,7 +346,7 @@ public: * @param value set True, this format will parse numbers as integers * only. * @see isParseIntegerOnly - * @stable + * @stable ICU 2.0 */ virtual void setParseIntegerOnly(UBool value); @@ -356,7 +356,7 @@ public: * the other factory methods: getNumberInstance, * getCurrencyInstance or getPercentInstance. Exactly which one * is locale dependant. - * @stable + * @stable ICU 2.0 */ static NumberFormat* createInstance(UErrorCode&); @@ -366,49 +366,49 @@ public: * factory methods: getNumberInstance, getCurrencyInstance or * getPercentInstance. Exactly which one is locale dependant. * @param inLocale the given locale. - * @stable + * @stable ICU 2.0 */ static NumberFormat* createInstance(const Locale& inLocale, UErrorCode&); /** * Returns a currency format for the current default locale. - * @stable + * @stable ICU 2.0 */ static NumberFormat* createCurrencyInstance(UErrorCode&); /** * Returns a currency format for the specified locale. * @param inLocale the given locale. - * @stable + * @stable ICU 2.0 */ static NumberFormat* createCurrencyInstance(const Locale& inLocale, UErrorCode&); /** * Returns a percentage format for the current default locale. - * @stable + * @stable ICU 2.0 */ static NumberFormat* createPercentInstance(UErrorCode&); /** * Returns a percentage format for the specified locale. * @param inLocale the given locale. - * @stable + * @stable ICU 2.0 */ static NumberFormat* createPercentInstance(const Locale& inLocale, UErrorCode&); /** * Returns a scientific format for the current default locale. - * @stable + * @stable ICU 2.0 */ static NumberFormat* createScientificInstance(UErrorCode&); /** * Returns a scientific format for the specified locale. * @param inLocale the given locale. - * @stable + * @stable ICU 2.0 */ static NumberFormat* createScientificInstance(const Locale& inLocale, UErrorCode&); @@ -416,7 +416,7 @@ public: /** * Get the set of Locales for which NumberFormats are installed. * @param count Output param to receive the size of the locales - * @stable + * @stable ICU 2.0 */ static const Locale* getAvailableLocales(int32_t& count); @@ -427,7 +427,7 @@ public: * well as the size of each group is locale dependant and is * determined by sub-classes of NumberFormat. * @see setGroupingUsed - * @stable + * @stable ICU 2.0 */ UBool isGroupingUsed(void) const; @@ -435,7 +435,7 @@ public: * Set whether or not grouping will be used in this format. * @param newValue True, grouping will be used in this format. * @see getGroupingUsed - * @stable + * @stable ICU 2.0 */ virtual void setGroupingUsed(UBool newValue); @@ -445,7 +445,7 @@ public: * @return the maximum number of digits allowed in the integer portion of a * number. * @see setMaximumIntegerDigits - * @stable + * @stable ICU 2.0 */ int32_t getMaximumIntegerDigits(void) const; @@ -459,7 +459,7 @@ public: * @param newValue the new value for the maximum number of digits * allowed in the integer portion of a number. * @see getMaximumIntegerDigits - * @stable + * @stable ICU 2.0 */ virtual void setMaximumIntegerDigits(int32_t newValue); @@ -469,7 +469,7 @@ public: * @return the minimum number of digits allowed in the integer portion of a * number. * @see setMinimumIntegerDigits - * @stable + * @stable ICU 2.0 */ int32_t getMinimumIntegerDigits(void) const; @@ -481,7 +481,7 @@ public: * the new value. * @param newValue the new value to be set. * @see getMinimumIntegerDigits - * @stable + * @stable ICU 2.0 */ virtual void setMinimumIntegerDigits(int32_t newValue); @@ -491,7 +491,7 @@ public: * @return the maximum number of digits allowed in the fraction portion of a * number. * @see setMaximumFractionDigits - * @stable + * @stable ICU 2.0 */ int32_t getMaximumFractionDigits(void) const; @@ -503,7 +503,7 @@ public: * the new value. * @param newValue the new value to be set. * @see getMaximumFractionDigits - * @stable + * @stable ICU 2.0 */ virtual void setMaximumFractionDigits(int32_t newValue); @@ -513,7 +513,7 @@ public: * @return the minimum number of digits allowed in the fraction portion of a * number. * @see setMinimumFractionDigits - * @stable + * @stable ICU 2.0 */ int32_t getMinimumFractionDigits(void) const; @@ -525,7 +525,7 @@ public: * the new value * @param newValue the new value to be set. * @see getMinimumFractionDigits - * @stable + * @stable ICU 2.0 */ virtual void setMinimumFractionDigits(int32_t newValue); @@ -540,7 +540,7 @@ public: * . Derived::getStaticClassID()) ... * * @return The class ID for all objects of this class. - * @stable + * @stable ICU 2.0 */ static UClassID getStaticClassID(void) { return (UClassID)&fgClassID; } @@ -554,7 +554,7 @@ public: * @return The class ID for this object. All objects of a * given class have the same class ID. Objects of * other classes have different class IDs. - * @stable + * @stable ICU 2.0 */ virtual UClassID getDynamicClassID(void) const { return getStaticClassID(); } @@ -562,19 +562,19 @@ protected: /** * Default constructor for subclass use only. - * @stable + * @stable ICU 2.0 */ NumberFormat(); /** * Copy constructor. - * @stable + * @stable ICU 2.0 */ NumberFormat(const NumberFormat&); /** * Assignment operator. - * @stable + * @stable ICU 2.0 */ NumberFormat& operator=(const NumberFormat&); diff --git a/icu4c/source/i18n/unicode/rbnf.h b/icu4c/source/i18n/unicode/rbnf.h index 47d614b73e..89551ea586 100644 --- a/icu4c/source/i18n/unicode/rbnf.h +++ b/icu4c/source/i18n/unicode/rbnf.h @@ -493,7 +493,7 @@ class Collator; * @author Richard Gillam * @see NumberFormat * @see DecimalFormat - * @stable + * @stable ICU 2.0 */ class U_I18N_API RuleBasedNumberFormat : public NumberFormat { public: @@ -515,7 +515,7 @@ public: * lenient parsing. * @param perror The parse error if an error was encountered. * @param status The status indicating whether the constructor succeeded. - * @stable + * @stable ICU 2.0 */ RuleBasedNumberFormat(const UnicodeString& rules, const Locale& locale, UParseError& perror, UErrorCode& status); @@ -531,7 +531,7 @@ public: * and URBNF_DURATION, which formats a duration in seconds as hours, minutes, and seconds. * @param locale The locale for the formatter. * @param status The status indicating whether the constructor succeeded. - * @stable + * @stable ICU 2.0 */ RuleBasedNumberFormat(URBNFRuleSetTag tag, const Locale& locale, UErrorCode& status); @@ -578,7 +578,7 @@ public: /** * return the rules that were provided to the RuleBasedNumberFormat. * @return the result String that was passed in - * @stable + * @stable ICU 2.0 */ virtual UnicodeString getRules() const; @@ -587,14 +587,14 @@ public: * the function returns null. * @param index the index of the ruleset * @return the name of the index'th public ruleSet. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString getRuleSetName(int32_t index) const; /** * Return the number of public rule set names. * @return the number of public rule set names. - * @stable + * @stable ICU 2.0 */ virtual int32_t getNumberOfRuleSetNames() const; @@ -604,7 +604,7 @@ public: * @param toAppendTo the string that will hold the (appended) result * @param pos the fieldposition * @return A textual representation of the number. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format(int32_t number, UnicodeString& toAppendTo, @@ -627,7 +627,7 @@ public: * @param toAppendTo the string that will hold the (appended) result * @param pos the fieldposition * @return A textual representation of the number. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format(double number, UnicodeString& toAppendTo, @@ -642,7 +642,7 @@ public: * @param pos the fieldposition * @param status the status * @return A textual representation of the number. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format(int32_t number, const UnicodeString& ruleSetName, @@ -674,7 +674,7 @@ public: * @param pos the fieldposition * @param status the status * @return A textual representation of the number. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format(double number, const UnicodeString& ruleSetName, @@ -689,7 +689,7 @@ public: * @param pos the fieldposition * @param status the status * @return A textual representation of the number. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format(const Formattable& obj, UnicodeString& toAppendTo, @@ -701,7 +701,7 @@ public: * @param result Output param which will receive the formatted string. * @param status Output param set to success/failure code * @return A reference to 'result'. - * @stable + * @stable ICU 2.0 */ UnicodeString& format(const Formattable& obj, UnicodeString& result, @@ -712,7 +712,7 @@ public: * @param number the double value to be formatted. * @param output Output param which will receive the formatted string. * @return A reference to 'output'. - * @stable + * @stable ICU 2.0 */ UnicodeString& format(double number, UnicodeString& output) const; @@ -722,7 +722,7 @@ public: * @param number the long value to be formatted. * @param output Output param which will receive the formatted string. * @return A reference to 'output'. - * @stable + * @stable ICU 2.0 */ UnicodeString& format(int32_t number, UnicodeString& output) const; @@ -739,7 +739,7 @@ public: * in "text" to examine. On exit, has been updated to contain the position * of the first character in "text" that wasn't consumed by the parse. * @see #setLenientParseMode - * @stable + * @stable ICU 2.0 */ virtual void parse(const UnicodeString& text, Formattable& result, @@ -751,7 +751,7 @@ public: * @param text The string to parse * @param result the result of the parse, either a double or a long. * @status Output param set to success/failure code. - * @stable + * @stable ICU 2.0 */ virtual inline void parse(const UnicodeString& text, Formattable& result, @@ -790,7 +790,7 @@ public: * * @param enabled If true, turns lenient-parse mode on; if false, turns it off. * @see RuleBasedCollator - * @stable + * @stable ICU 2.0 */ virtual void setLenient(UBool enabled); @@ -799,7 +799,7 @@ public: * by default. * @return true if lenient-parse mode is turned on. * @see #setLenientParseMode - * @stable + * @stable ICU 2.0 */ virtual inline UBool isLenient(void) const; diff --git a/icu4c/source/i18n/unicode/search.h b/icu4c/source/i18n/unicode/search.h index baa59b27b0..08a6d4252b 100644 --- a/icu4c/source/i18n/unicode/search.h +++ b/icu4c/source/i18n/unicode/search.h @@ -21,11 +21,11 @@ #include "unicode/usearch.h" /** -* @stable +* @stable ICU 2.0 */ struct USearch; /** -* @stable +* @stable ICU 2.0 */ typedef struct USearch USearch; @@ -80,13 +80,13 @@ public: * Copy constructor that creates a SearchIterator instance with the same * behavior, and iterating over the same text. * @param other the SearchIterator instance to be copied. - * @stable + * @stable ICU 2.0 */ SearchIterator(const SearchIterator &other); /** * Destructor. Cleans up the search iterator data struct. - * @stable + * @stable ICU 2.0 */ virtual ~SearchIterator(); @@ -103,7 +103,7 @@ public: * than or greater than the text range for searching, * an U_INDEX_OUTOFBOUNDS_ERROR will be returned * @param status for errors if it occurs - * @stable + * @stable ICU 2.0 */ virtual void setOffset(int32_t position, UErrorCode &status) = 0; @@ -113,7 +113,7 @@ public: * (or past the beginning for a backwards search), USEARCH_DONE * is returned. * @return current index in the text being searched. - * @stable + * @stable ICU 2.0 */ virtual int32_t getOffset(void) const = 0; @@ -124,7 +124,7 @@ public: * @param attribute text attribute (enum USearchAttribute) to be set * @param value text attribute value * @param status for errors if it occurs - * @stable + * @stable ICU 2.0 */ void setAttribute(USearchAttribute attribute, USearchAttributeValue value, @@ -134,7 +134,7 @@ public: * Gets the text searching attributes * @param attribute text attribute (enum USearchAttribute) to be retrieve * @return text attribute value - * @stable + * @stable ICU 2.0 */ USearchAttributeValue getAttribute(USearchAttribute attribute) const; @@ -152,7 +152,7 @@ public: * @see #next * @see #previous * @see #last - * @stable + * @stable ICU 2.0 */ int32_t getMatchedStart(void) const; @@ -168,7 +168,7 @@ public: * @see #next * @see #previous * @see #last - * @stable + * @stable ICU 2.0 */ int32_t getMatchedLength(void) const; @@ -184,7 +184,7 @@ public: * @see #next * @see #previous * @see #last - * @stable + * @stable ICU 2.0 */ void getMatchedText(UnicodeString &result) const; @@ -201,7 +201,7 @@ public: * detection is attempted. * @param status for errors if it occurs * @see BreakIterator - * @stable + * @stable ICU 2.0 */ void setBreakIterator(BreakIterator *breakiter, UErrorCode &status); @@ -213,7 +213,7 @@ public: * detection should not be attempted. * @return BreakIterator used to restrict matchings. * @see #setBreakIterator - * @stable + * @stable ICU 2.0 */ const BreakIterator * getBreakIterator(void) const; @@ -225,7 +225,7 @@ public: * @param text string to be searched. * @param status for errors. If the text length is 0, * an U_ILLEGAL_ARGUMENT_ERROR is returned. - * @stable + * @stable ICU 2.0 */ virtual void setText(const UnicodeString &text, UErrorCode &status); @@ -242,14 +242,14 @@ public: * @param text string iterator to be searched. * @param status for errors if any. If the text length is 0 then an * U_ILLEGAL_ARGUMENT_ERROR is returned. - * @stable + * @stable ICU 2.0 */ virtual void setText(CharacterIterator &text, UErrorCode &status); /** * Return the string text to be searched. * @return text string to be searched. - * @stable + * @stable ICU 2.0 */ const UnicodeString & getText(void) const; @@ -261,7 +261,7 @@ public: * @return TRUE if both BreakIterators are of the same class, have the * same behavior, terates over the same text and have the same * attributes. FALSE otherwise. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const SearchIterator &that) const; @@ -269,7 +269,7 @@ public: * Not-equal operator. * @param that SearchIterator instance to be compared. * @return FALSE if operator== returns TRUE, and vice versa. - * @stable + * @stable ICU 2.0 */ UBool operator!=(const SearchIterator &that) const; @@ -280,7 +280,7 @@ public: * iterating over the same text, as this one. Note that all data will be * replicated, except for the text string to be searched. * @return cloned object - * @stable + * @stable ICU 2.0 */ virtual SearchIterator* safeClone(void) const = 0; @@ -295,7 +295,7 @@ public: * @return The character index of the first match, or * USEARCH_DONE if there are no matches. * @see #getOffset - * @stable + * @stable ICU 2.0 */ int32_t first(UErrorCode &status); @@ -314,7 +314,7 @@ public: * position, or USEARCH_DONE if there are no * matches. * @see #getOffset - * @stable + * @stable ICU 2.0 */ int32_t following(int32_t position, UErrorCode &status); @@ -329,7 +329,7 @@ public: * @return The index of the first match, or USEARCH_DONE if * there are no matches. * @see #getOffset - * @stable + * @stable ICU 2.0 */ int32_t last(UErrorCode &status); @@ -348,7 +348,7 @@ public: * position, or USEARCH_DONE if there are * no matches. * @see #getOffset - * @stable + * @stable ICU 2.0 */ int32_t preceding(int32_t position, UErrorCode &status); @@ -364,7 +364,7 @@ public: * @return The index of the next match after the current position, * or USEARCH_DONE if there are no more matches. * @see #getOffset - * @stable + * @stable ICU 2.0 */ int32_t next(UErrorCode &status); @@ -379,7 +379,7 @@ public: * @return The index of the previous match before the current position, * or USEARCH_DONE if there are no more matches. * @see #getOffset - * @stable + * @stable ICU 2.0 */ int32_t previous(UErrorCode &status); @@ -389,7 +389,7 @@ public: * iteration is initiated before a backwards iteration. Otherwise if a * backwards iteration is initiated before a forwards iteration, the * search will begin at the end of the text string. - * @stable + * @stable ICU 2.0 */ virtual void reset(); @@ -423,7 +423,7 @@ protected: /** * Default constructor. * Initializes data to the default values. - * @stable + * @stable ICU 2.0 */ SearchIterator(); diff --git a/icu4c/source/i18n/unicode/simpletz.h b/icu4c/source/i18n/unicode/simpletz.h index 803055a78f..8f1d2f31b6 100644 --- a/icu4c/source/i18n/unicode/simpletz.h +++ b/icu4c/source/i18n/unicode/simpletz.h @@ -74,20 +74,20 @@ public: /** * Copy constructor * @param source the object to be copied. - * @stable + * @stable ICU 2.0 */ SimpleTimeZone(const SimpleTimeZone& source); /** * Default assignment operator * @param right the object to be copied. - * @stable + * @stable ICU 2.0 */ SimpleTimeZone& operator=(const SimpleTimeZone& right); /** * Destructor - * @stable + * @stable ICU 2.0 */ virtual ~SimpleTimeZone(); @@ -98,7 +98,7 @@ public: * @param that The SimpleTimeZone object to be compared with. * @return True if the given time zone is equal to this time zone; false * otherwise. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const TimeZone& that) const; @@ -111,7 +111,7 @@ public: * @param rawOffsetGMT The given base time zone offset to GMT. * @param ID The timezone ID which is obtained from * TimeZone.getAvailableIDs. - * @stable + * @stable ICU 2.0 */ SimpleTimeZone(int32_t rawOffsetGMT, const UnicodeString& ID); @@ -154,7 +154,7 @@ public: * @param savingsDST The number of milliseconds added to standard time * to get DST time. Default is one hour. * @param status An UErrorCode to receive the status. - * @stable + * @stable ICU 2.0 */ SimpleTimeZone(int32_t rawOffsetGMT, const UnicodeString& ID, int8_t savingsStartMonth, int8_t savingsStartDayOfWeekInMonth, @@ -184,7 +184,7 @@ public: * not to observe daylight savings time prior to that year; SimpleTimeZone doesn't * support historical daylight-savings-time rules. * @param year the daylight savings starting year. - * @stable + * @stable ICU 2.0 */ void setStartYear(int32_t year); @@ -228,7 +228,7 @@ public: * @param mode whether the time is local wall time, local standard time, * or UTC time. Default is local wall time. * @param status An UErrorCode - * @stable + * @stable ICU 2.0 */ void setStartRule(int32_t month, int32_t dayOfWeekInMonth, int32_t dayOfWeek, int32_t time, UErrorCode& status); @@ -247,7 +247,7 @@ public: * @param mode whether the time is local wall time, local standard time, * or UTC time. Default is local wall time. * @param status An UErrorCode - * @stable + * @stable ICU 2.0 */ void setStartRule(int32_t month, int32_t dayOfMonth, int32_t time, UErrorCode& status); @@ -271,7 +271,7 @@ public: * or after dayOfMonth. If false, this rule selects * the last dayOfWeek on or before dayOfMonth. * @param status An UErrorCode - * @stable + * @stable ICU 2.0 */ void setStartRule(int32_t month, int32_t dayOfMonth, int32_t dayOfWeek, int32_t time, UBool after, UErrorCode& status); @@ -301,7 +301,7 @@ public: * @param mode whether the time is local wall time, local standard time, * or UTC time. Default is local wall time. * @param status An UErrorCode - * @stable + * @stable ICU 2.0 */ void setEndRule(int32_t month, int32_t dayOfWeekInMonth, int32_t dayOfWeek, int32_t time, UErrorCode& status); @@ -320,7 +320,7 @@ public: * @param mode whether the time is local wall time, local standard time, * or UTC time. Default is local wall time. * @param status An UErrorCode - * @stable + * @stable ICU 2.0 */ void setEndRule(int32_t month, int32_t dayOfMonth, int32_t time, UErrorCode& status); @@ -343,7 +343,7 @@ public: * or after dayOfMonth. If false, this rule selects * the last dayOfWeek on or before dayOfMonth. * @param status An UErrorCode - * @stable + * @stable ICU 2.0 */ void setEndRule(int32_t month, int32_t dayOfMonth, int32_t dayOfWeek, int32_t time, UBool after, UErrorCode& status); @@ -369,7 +369,7 @@ public: * @param millis The reference date's milliseconds in day, UTT (NOT local time). * @param status An UErrorCode to receive the status. * @return The offset in milliseconds to add to GMT to get local time. - * @stable + * @stable ICU 2.0 */ virtual int32_t getOffset(uint8_t era, int32_t year, int32_t month, int32_t day, uint8_t dayOfWeek, int32_t millis, UErrorCode& status) const; @@ -391,7 +391,7 @@ public: * @param prevMonthLength length of the previous month in days. * @param status An UErrorCode to receive the status. * @return the offset to add *to* GMT to get local time. - * @stable + * @stable ICU 2.0 */ virtual int32_t getOffset(uint8_t era, int32_t year, int32_t month, int32_t day, uint8_t dayOfWeek, int32_t milliseconds, @@ -407,7 +407,7 @@ public: * to GMT to get local time, before taking daylight savings time into account). * * @return The TimeZone's raw GMT offset. - * @stable + * @stable ICU 2.0 */ virtual int32_t getRawOffset(void) const; @@ -416,7 +416,7 @@ public: * to GMT to get local time, before taking daylight savings time into account). * * @param offsetMillis The new raw GMT offset for this time zone. - * @stable + * @stable ICU 2.0 */ virtual void setRawOffset(int32_t offsetMillis); @@ -426,7 +426,7 @@ public: * advanced with respect to standard time when the daylight savings rules * are in effect. A positive number, typically one hour (3600000). * @param status An UErrorCode to receive the status. - * @stable + * @stable ICU 2.0 */ void setDSTSavings(int32_t millisSavedDuringDST, UErrorCode& status); @@ -442,7 +442,7 @@ public: * Queries if this TimeZone uses Daylight Savings Time. * * @return True if this TimeZone uses Daylight Savings Time; false otherwise. - * @stable + * @stable ICU 2.0 */ virtual UBool useDaylightTime(void) const; @@ -466,7 +466,7 @@ public: * Return true if this zone has the same rules and offset as another zone. * @param other the TimeZone object to be compared with * @return true if the given zone has the same rules and offset as this one - * @stable + * @stable ICU 2.0 */ UBool hasSameRules(const TimeZone& other) const; @@ -475,7 +475,7 @@ public: * the TimeZone object cloned. * * @return A new copy of this TimeZone object. - * @stable + * @stable ICU 2.0 */ virtual TimeZone* clone(void) const; @@ -489,7 +489,7 @@ public: * * @return The class ID for this object. All objects of a given class have the * same class ID. Objects of other classes have different class IDs. - * @stable + * @stable ICU 2.0 */ virtual UClassID getDynamicClassID(void) const { return (UClassID)&fgClassID; } @@ -502,7 +502,7 @@ public: * . Derived::getStaticClassID()) ... * * @return The class ID for all objects of this class. - * @stable + * @stable ICU 2.0 */ static UClassID getStaticClassID(void) { return (UClassID)&fgClassID; } diff --git a/icu4c/source/i18n/unicode/smpdtfmt.h b/icu4c/source/i18n/unicode/smpdtfmt.h index ddc0d9aa3b..e022e2c493 100644 --- a/icu4c/source/i18n/unicode/smpdtfmt.h +++ b/icu4c/source/i18n/unicode/smpdtfmt.h @@ -184,7 +184,7 @@ public: * [Note:] Not all locales support SimpleDateFormat; for full generality, * use the factory methods in the DateFormat class. * @param status Output param set to success/failure code. - * @stable + * @stable ICU 2.0 */ SimpleDateFormat(UErrorCode& status); @@ -197,7 +197,7 @@ public: * use the factory methods in the DateFormat class. * @param pattern the pattern for the format. * @param status Output param set to success/failure code. - * @stable + * @stable ICU 2.0 */ SimpleDateFormat(const UnicodeString& pattern, UErrorCode& status); @@ -212,7 +212,7 @@ public: * @param pattern the pattern for the format. * @param locale the given locale. * @param staus Output param set to success/failure code. - * @stable + * @stable ICU 2.0 */ SimpleDateFormat(const UnicodeString& pattern, const Locale& locale, @@ -225,7 +225,7 @@ public: * @param pattern the given pattern for the format. * @param formatDataToAdopt the symbols to be adopted. * @param staus Output param set to success/faulure code. - * @stable + * @stable ICU 2.0 */ SimpleDateFormat(const UnicodeString& pattern, DateFormatSymbols* formatDataToAdopt, @@ -238,7 +238,7 @@ public: * @param pattern the given pattern for the format. * @param formatDataToAdopt the symbols to be set. * @param staus Output param set to success/faulure code. - * @stable + * @stable ICU 2.0 */ SimpleDateFormat(const UnicodeString& pattern, const DateFormatSymbols& formatData, @@ -246,19 +246,19 @@ public: /** * Copy constructor. - * @stable + * @stable ICU 2.0 */ SimpleDateFormat(const SimpleDateFormat&); /** * Assignment operator. - * @stable + * @stable ICU 2.0 */ SimpleDateFormat& operator=(const SimpleDateFormat&); /** * Destructor. - * @stable + * @stable ICU 2.0 */ virtual ~SimpleDateFormat(); @@ -266,7 +266,7 @@ public: * Clone this Format object polymorphically. The caller owns the result and * should delete it when done. * @return A copy of the object. - * @stable + * @stable ICU 2.0 */ virtual Format* clone(void) const; @@ -275,7 +275,7 @@ public: * of different subclasses are considered unequal. * @param other the object to be compared with. * @return true if the given Format objects are semantically equal. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const Format& other) const; @@ -316,7 +316,7 @@ public: * if desired. On output: the offsets of the alignment field. * @param status Output param set to success/faulure code. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& format( const Formattable& obj, UnicodeString& appendTo, @@ -344,7 +344,7 @@ public: * Result is appended to existing contents. * @param status Input/output success/failure code. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ UnicodeString& format(const Formattable& obj, UnicodeString& appendTo, @@ -356,7 +356,7 @@ public: * @param appendTo Output parameter to receive result. * Result is appended to existing contents. * @return Reference to 'appendTo' parameter. - * @stable + * @stable ICU 2.0 */ UnicodeString& format(UDate date, UnicodeString& appendTo) const; @@ -400,7 +400,7 @@ public: * output, the position at which parsing terminated, or the * start position if the parse failed. * @return A valid UDate if the input could be parsed. - * @stable + * @stable ICU 2.0 */ UDate parse( const UnicodeString& text, ParsePosition& pos) const; @@ -419,7 +419,7 @@ public: * @param status Filled in with U_ZERO_ERROR if the parse was successful, and with * an error value if there was a parse error. * @return A valid UDate if the input could be parsed. - * @stable + * @stable ICU 2.0 */ virtual UDate parse( const UnicodeString& text, UErrorCode& status) const; @@ -438,7 +438,7 @@ public: * @param d start UDate used to interpret two-digit year strings. * @param status Filled in with U_ZERO_ERROR if the parse was successful, and with * an error value if there was a parse error. - * @stable + * @stable ICU 2.0 */ virtual void set2DigitYearStart(UDate d, UErrorCode& status); @@ -455,7 +455,7 @@ public: * time at which a SimpleDateFormat object is created. * @param status Filled in with U_ZERO_ERROR if the parse was successful, and with * an error value if there was a parse error. - * @stable + * @stable ICU 2.0 */ UDate get2DigitYearStart(UErrorCode& status) const; @@ -463,7 +463,7 @@ public: * Return a pattern string describing this date format. * @param result Output param to receive the pattern. * @return A reference to 'result'. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& toPattern(UnicodeString& result) const; @@ -481,7 +481,7 @@ public: * exit. If the pattern is invalid, this will be * set to a failure result. * @return A reference to 'result'. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& toLocalizedPattern(UnicodeString& result, UErrorCode& status) const; @@ -492,7 +492,7 @@ public: * the new pattern) * * @param pattern The pattern to be applied. - * @stable + * @stable ICU 2.0 */ virtual void applyPattern(const UnicodeString& pattern); @@ -504,7 +504,7 @@ public: * @param status Output param set to success/failure code on * exit. If the pattern is invalid, this will be * set to a failure result. - * @stable + * @stable ICU 2.0 */ virtual void applyLocalizedPattern(const UnicodeString& pattern, UErrorCode& status); @@ -515,7 +515,7 @@ public: * names and abbreviations, time zone names, AM/PM strings, etc.) * @return a copy of the date-time formatting data associated * with this date-time formatter. - * @stable + * @stable ICU 2.0 */ virtual const DateFormatSymbols* getDateFormatSymbols(void) const; @@ -523,14 +523,14 @@ public: * Set the date/time formatting symbols. The caller no longer owns the * DateFormatSymbols object and should not delete it after making this call. * @param newFormatData the given date-time formatting data. - * @stable + * @stable ICU 2.0 */ virtual void adoptDateFormatSymbols(DateFormatSymbols* newFormatSymbols); /** * Set the date/time formatting data. * @param newFormatData the given date-time formatting data. - * @stable + * @stable ICU 2.0 */ virtual void setDateFormatSymbols(const DateFormatSymbols& newFormatSymbols); @@ -543,7 +543,7 @@ public: * . erived::getStaticClassID()) ... * * @return The class ID for all objects of this class. - * @stable + * @stable ICU 2.0 */ static UClassID getStaticClassID(void) { return (UClassID)&fgClassID; } @@ -556,7 +556,7 @@ public: * @return The class ID for this object. All objects of a * given class have the same class ID. Objects of * other classes have different class IDs. - * @stable + * @stable ICU 2.0 */ virtual UClassID getDynamicClassID(void) const { return getStaticClassID(); } diff --git a/icu4c/source/i18n/unicode/sortkey.h b/icu4c/source/i18n/unicode/sortkey.h index 6338a490ba..5b59fa3cc8 100644 --- a/icu4c/source/i18n/unicode/sortkey.h +++ b/icu4c/source/i18n/unicode/sortkey.h @@ -94,7 +94,7 @@ public: * collation key contains no sorting information. When comparing two empty * collation keys, the result is Collator::EQUAL. Comparing empty collation key * with non-empty collation key is always Collator::LESS. - * @stable + * @stable ICU 2.0 */ CollationKey(); @@ -104,7 +104,7 @@ public: * @param values the collation key values * @param count number of collation key values, including trailing nulls. * @see #createBits - * @stable + * @stable ICU 2.0 */ CollationKey(const uint8_t* values, int32_t count); @@ -112,20 +112,20 @@ public: /** * Copy constructor. * @param other the object to be copied. - * @stable + * @stable ICU 2.0 */ CollationKey(const CollationKey& other); /** * Sort key destructor. - * @stable + * @stable ICU 2.0 */ ~CollationKey(); /** * Assignment operator * @param other the object to be copied. - * @stable + * @stable ICU 2.0 */ const CollationKey& operator=(const CollationKey& other); @@ -133,7 +133,7 @@ public: * Compare if two collation keys are the same. * @param source the collation key to compare to. * @return Returns true if two collation keys are equal, false otherwise. - * @stable + * @stable ICU 2.0 */ UBool operator==(const CollationKey& source) const; @@ -141,7 +141,7 @@ public: * Compare if two collation keys are not the same. * @param source the collation key to compare to. * @return Returns TRUE if two collation keys are different, FALSE otherwise. - * @stable + * @stable ICU 2.0 */ UBool operator!=(const CollationKey& source) const; @@ -150,7 +150,7 @@ public: * Test to see if the key is in an invalid state. The key will be in an * invalid state if it couldn't allocate memory for some operation. * @return Returns TRUE if the key is in an invalid, FALSE otherwise. - * @stable + * @stable ICU 2.0 */ UBool isBogus(void) const; @@ -161,7 +161,7 @@ public: * @param count the output parameter of number of collation key values, * including any trailing nulls. * @return a pointer to the collation key values. - * @stable + * @stable ICU 2.0 */ const uint8_t* getByteArray(int32_t& count) const; @@ -181,7 +181,7 @@ public: * @return Returns Collator::LESS if sourceKey < targetKey, * Collator::GREATER if sourceKey > targetKey and Collator::EQUAL * otherwise. - * @stable + * @stable ICU 2.0 */ Collator::EComparisonResult compareTo(const CollationKey& target) const; @@ -203,7 +203,7 @@ public: * * @return the hash value based on the string's collation order. * @see UnicodeString#hashCode - * @stable + * @stable ICU 2.0 */ int32_t hashCode(void) const; diff --git a/icu4c/source/i18n/unicode/stsearch.h b/icu4c/source/i18n/unicode/stsearch.h index 13ac6cd345..95a529e40b 100644 --- a/icu4c/source/i18n/unicode/stsearch.h +++ b/icu4c/source/i18n/unicode/stsearch.h @@ -152,7 +152,7 @@ public: * @param status for errors if any. If pattern or text is NULL, or if * either the length of pattern or text is 0 then an * U_ILLEGAL_ARGUMENT_ERROR is returned. - * @stable + * @stable ICU 2.0 */ StringSearch(const UnicodeString &pattern, const UnicodeString &text, const Locale &locale, @@ -178,7 +178,7 @@ public: * NULL can be passed in instead. * @param status for errors if any. If either the length of pattern or * text is 0 then an U_ILLEGAL_ARGUMENT_ERROR is returned. - * @stable + * @stable ICU 2.0 */ StringSearch(const UnicodeString &pattern, const UnicodeString &text, @@ -209,7 +209,7 @@ public: * NULL can be passed in instead. * @param status for errors if any. If either the length of pattern or * text is 0 then an U_ILLEGAL_ARGUMENT_ERROR is returned. - * @stable + * @stable ICU 2.0 */ StringSearch(const UnicodeString &pattern, CharacterIterator &text, const Locale &locale, @@ -239,7 +239,7 @@ public: * NULL can be passed in instead. * @param status for errors if any. If either the length of pattern or * text is 0 then an U_ILLEGAL_ARGUMENT_ERROR is returned. - * @stable + * @stable ICU 2.0 */ StringSearch(const UnicodeString &pattern, CharacterIterator &text, RuleBasedCollator *coll, @@ -250,14 +250,14 @@ public: * Copy constructor that creates a StringSearch instance with the same * behavior, and iterating over the same text. * @param that StringSearch instance to be copied. - * @stable + * @stable ICU 2.0 */ StringSearch(const StringSearch &that); /** * Destructor. Cleans up the search iterator data struct. * If a collator is created in the constructor, it will be destroyed here. - * @stable + * @stable ICU 2.0 */ virtual ~StringSearch(void); @@ -267,7 +267,7 @@ public: * Assignment operator. Sets this iterator to have the same behavior, * and iterate over the same text, as the one passed in. * @param that instance to be copied. - * @stable + * @stable ICU 2.0 */ StringSearch & operator=(const StringSearch &that); @@ -277,7 +277,7 @@ public: * @return TRUE if both instances have the same attributes, * breakiterators, collators and iterate over the same text * while looking for the same pattern. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const SearchIterator &that) const; @@ -294,7 +294,7 @@ public: * than or greater than the text range for searching, * an U_INDEX_OUTOFBOUNDS_ERROR will be returned * @param status for errors if it occurs - * @stable + * @stable ICU 2.0 */ virtual void setOffset(int32_t position, UErrorCode &status); @@ -304,7 +304,7 @@ public: * (or past the beginning for a backwards search), USEARCH_DONE * is returned. * @return current index in the text being searched. - * @stable + * @stable ICU 2.0 */ virtual int32_t getOffset(void) const; @@ -317,7 +317,7 @@ public: * @param text text string to be searched * @param status for errors if any. If the text length is 0 then an * U_ILLEGAL_ARGUMENT_ERROR is returned. - * @stable + * @stable ICU 2.0 */ virtual void setText(const UnicodeString &text, UErrorCode &status); @@ -333,7 +333,7 @@ public: * @param text text string to be searched * @param status for errors if any. If the text length is 0 then an * U_ILLEGAL_ARGUMENT_ERROR is returned. - * @stable + * @stable ICU 2.0 */ virtual void setText(CharacterIterator &text, UErrorCode &status); @@ -344,7 +344,7 @@ public: * the destructor would cause the string search to fail. * The destructor will delete the collator if this instance owns it * @return collator used for string search - * @stable + * @stable ICU 2.0 */ RuleBasedCollator * getCollator() const; @@ -356,7 +356,7 @@ public: * unchanged. * @param coll collator * @param status for errors if any - * @stable + * @stable ICU 2.0 */ void setCollator(RuleBasedCollator *coll, UErrorCode &status); @@ -367,14 +367,14 @@ public: * @param pattern search pattern to be found * @param status for errors if any. If the pattern length is 0 then an * U_ILLEGAL_ARGUMENT_ERROR is returned. - * @stable + * @stable ICU 2.0 */ void setPattern(const UnicodeString &pattern, UErrorCode &status); /** * Gets the search pattern. * @return pattern used for matching - * @stable + * @stable ICU 2.0 */ const UnicodeString & getPattern() const; @@ -386,7 +386,7 @@ public: * iteration is initiated before a backwards iteration. Otherwise if * a backwards iteration is initiated before a forwards iteration, the * search will begin at the end of the text string. - * @stable + * @stable ICU 2.0 */ virtual void reset(); @@ -396,7 +396,7 @@ public: * replicated, except for the user-specified collator and the * breakiterator. * @return cloned object - * @stable + * @stable ICU 2.0 */ virtual SearchIterator * safeClone(void) const; diff --git a/icu4c/source/i18n/unicode/tblcoll.h b/icu4c/source/i18n/unicode/tblcoll.h index 165cc6d9c5..fd7bd01aee 100644 --- a/icu4c/source/i18n/unicode/tblcoll.h +++ b/icu4c/source/i18n/unicode/tblcoll.h @@ -65,11 +65,11 @@ U_NAMESPACE_BEGIN /** -* @stable +* @stable ICU 2.0 */ class StringSearch; /** -* @stable +* @stable ICU 2.0 */ class CollationElementIterator; @@ -114,7 +114,7 @@ public: * @param rules the collation rules to build the collation table from. * @param status reporting a success or an error. * @see Locale - * @stable + * @stable ICU 2.0 */ RuleBasedCollator(const UnicodeString& rules, UErrorCode& status); @@ -126,7 +126,7 @@ public: * @param collationStrength default strength for comparison * @param status reporting a success or an error. * @see Locale - * @stable + * @stable ICU 2.0 */ RuleBasedCollator(const UnicodeString& rules, ECollationStrength collationStrength, @@ -140,7 +140,7 @@ public: * @param decompositionMode the normalisation mode * @param status reporting a success or an error. * @see Locale - * @stable + * @stable ICU 2.0 */ RuleBasedCollator(const UnicodeString& rules, UColAttributeValue decompositionMode, @@ -155,7 +155,7 @@ public: * @param decompositionMode the normalisation mode * @param status reporting a success or an error. * @see Locale - * @stable + * @stable ICU 2.0 */ RuleBasedCollator(const UnicodeString& rules, ECollationStrength collationStrength, @@ -166,7 +166,7 @@ public: * Copy constructor. * @param the RuleBasedCollator object to be copied * @see Locale - * @stable + * @stable ICU 2.0 */ RuleBasedCollator(const RuleBasedCollator& other); @@ -174,7 +174,7 @@ public: /** * Destructor. - * @stable + * @stable ICU 2.0 */ virtual ~RuleBasedCollator(); @@ -183,7 +183,7 @@ public: /** * Assignment operator. * @param other other RuleBasedCollator object to compare with. - * @stable + * @stable ICU 2.0 */ RuleBasedCollator& operator=(const RuleBasedCollator& other); @@ -191,7 +191,7 @@ public: * Returns true if argument is the same as this object. * @param other Collator object to be compared. * @return true if arguments is the same as this object. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const Collator& other) const; @@ -199,7 +199,7 @@ public: * Returns true if argument is not the same as this object. * @param other Collator object to be compared * @return returns true if argument is not the same as this object. - * @stable + * @stable ICU 2.0 */ virtual UBool operator!=(const Collator& other) const; @@ -207,7 +207,7 @@ public: * Makes a deep copy of the object. * The caller owns the returned object. * @return the cloned object. - * @stable + * @stable ICU 2.0 */ virtual Collator* clone(void) const; @@ -246,7 +246,7 @@ public: * @return the comparison result. GREATER if the source string is greater * than the target string, LESS if the source is less than the * target. Otherwise, returns EQUAL. - * @stable + * @stable ICU 2.0 */ virtual EComparisonResult compare(const UnicodeString& source, const UnicodeString& target) const; @@ -263,7 +263,7 @@ public: * @return the comparison result. GREATER if the source string is greater * than the target string, LESS if the source is less than the * target. Otherwise, returns EQUAL. - * @stable + * @stable ICU 2.0 */ virtual EComparisonResult compare(const UnicodeString& source, const UnicodeString& target, @@ -316,7 +316,7 @@ public: * @param status the error code status. * @return the transformed key. * @see CollationKey - * @stable + * @stable ICU 2.0 */ virtual CollationKey& getCollationKey(const UnicodeString& source, CollationKey& key, @@ -332,7 +332,7 @@ public: * @param status the error code status. * @return the transformed key. * @see CollationKey - * @stable + * @stable ICU 2.0 */ virtual CollationKey& getCollationKey(const UChar *source, int32_t sourceLength, @@ -342,7 +342,7 @@ public: /** * Generates the hash code for the rule-based collation object. * @return the hash code. - * @stable + * @stable ICU 2.0 */ virtual int32_t hashCode(void) const; @@ -362,14 +362,14 @@ public: * Gets the table-based rules for the collation object. * @return returns the collation rules that the table collation object was * created from. - * @stable + * @stable ICU 2.0 */ const UnicodeString& getRules(void) const; /** * Gets the version information for a Collator. * @param info the version # information, the result will be filled in - * @stable + * @stable ICU 2.0 */ virtual void getVersion(UVersionInfo info) const; @@ -381,7 +381,7 @@ public: * element or 1 if collation element does not occur at the end of * any expansion sequence * @see CollationElementIterator#getMaxExpansion - * @stable + * @stable ICU 2.0 */ int32_t getMaxExpansion(int32_t order) const; @@ -393,7 +393,7 @@ public: * @return The class ID for this object. All objects of a given class have * the same class ID. Objects of other classes have different class * IDs. - * @stable + * @stable ICU 2.0 */ virtual UClassID getDynamicClassID(void) const { @@ -409,7 +409,7 @@ public: * Derived::getStaticClassID()) ... * * @return The class ID for all objects of this class. - * @stable + * @stable ICU 2.0 */ static UClassID getStaticClassID(void) { @@ -463,7 +463,7 @@ public: * U_CE_NOT_FOUND_ERROR if more than one character was passed and there is no such a contraction
* U_PRIMARY_TOO_LONG_ERROR if the primary for the variable top has more than two bytes * @return a 32 bit value containing the value of the variable top in upper 16 bits. Lower 16 bits are undefined - * @stable + * @stable ICU 2.0 */ virtual uint32_t setVariableTop(const UChar *varTop, int32_t len, UErrorCode &status); @@ -474,7 +474,7 @@ public: * U_CE_NOT_FOUND_ERROR if more than one character was passed and there is no such a contraction
* U_PRIMARY_TOO_LONG_ERROR if the primary for the variable top has more than two bytes * @return a 32 bit value containing the value of the variable top in upper 16 bits. Lower 16 bits are undefined - * @stable + * @stable ICU 2.0 */ virtual uint32_t setVariableTop(const UnicodeString varTop, UErrorCode &status); @@ -483,7 +483,7 @@ public: * Lower 16 bits are ignored. * @param varTop CE value, as returned by setVariableTop or ucol)getVariableTop * @param status error code (not changed by function) - * @stable + * @stable ICU 2.0 */ virtual void setVariableTop(const uint32_t varTop, UErrorCode &status); @@ -491,7 +491,7 @@ public: * Gets the variable top value of a Collator. * Lower 16 bits are undefined and should be ignored. * @param status error code (not changed by function). If error code is set, the return value is undefined. - * @stable + * @stable ICU 2.0 */ virtual uint32_t getVariableTop(UErrorCode &status) const; @@ -521,7 +521,7 @@ public: * @param resultLength length of the result buffer. If if not enough the * buffer will be filled to capacity. * @return Number of bytes needed for storing the sort key - * @stable + * @stable ICU 2.0 */ virtual int32_t getSortKey(const UnicodeString& source, uint8_t *result, int32_t resultLength) const; @@ -549,7 +549,7 @@ public: * are ignored. * @return the current comparison level. * @see RuleBasedCollator#setStrength - * @stable + * @stable ICU 2.0 */ virtual ECollationStrength getStrength(void) const; @@ -557,7 +557,7 @@ public: * Sets the minimum strength to be used in comparison or transformation. * @see RuleBasedCollator#getStrength * @param newStrength the new comparison level. - * @stable + * @stable ICU 2.0 */ virtual void setStrength(ECollationStrength newStrength); diff --git a/icu4c/source/i18n/unicode/timezone.h b/icu4c/source/i18n/unicode/timezone.h index 6e88c62a37..676abd3130 100644 --- a/icu4c/source/i18n/unicode/timezone.h +++ b/icu4c/source/i18n/unicode/timezone.h @@ -112,7 +112,7 @@ class StringEnumeration; class U_I18N_API TimeZone : public UObject { public: /** - * @stable + * @stable ICU 2.0 */ virtual ~TimeZone(); @@ -130,7 +130,7 @@ public: * The GMT time zone has a raw offset of zero and does not use daylight * savings time. This is a commonly used time zone. * @return the GMT time zone. - * @stable + * @stable ICU 2.0 */ static const TimeZone* getGMT(void); @@ -143,7 +143,7 @@ public: * cannot be understood. Return result guaranteed to be non-null. If you * require that the specific zone asked for be returned, check the ID of the * return result. - * @stable + * @stable ICU 2.0 */ static TimeZone* createTimeZone(const UnicodeString& ID); @@ -263,7 +263,7 @@ public: * @return the number of zones in the equivalency group containing * 'id', or zero if 'id' is not a valid system ID * @see #getEquivalentID - * @stable + * @stable ICU 2.0 */ static int32_t countEquivalentIDs(const UnicodeString& id); @@ -284,7 +284,7 @@ public: * containing 'id', or an empty string if 'id' is not a valid * system ID or 'index' is out of range * @see #countEquivalentIDs - * @stable + * @stable ICU 2.0 */ static const UnicodeString getEquivalentID(const UnicodeString& id, int32_t index); @@ -299,7 +299,7 @@ public: * * @return A default TimeZone. Clients are responsible for deleting the time zone * object returned. - * @stable + * @stable ICU 2.0 */ static TimeZone* createDefault(void); @@ -310,7 +310,7 @@ public: * passed in; the clent is no longer responsible for deleting it. * * @param zone A pointer to the new TimeZone object to use as the default. - * @stable + * @stable ICU 2.0 */ static void adoptDefault(TimeZone* zone); @@ -330,7 +330,7 @@ public: * @param that The TimeZone object to be compared with. * @return True if the given TimeZone is equal to this TimeZone; false * otherwise. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const TimeZone& that) const; @@ -341,7 +341,7 @@ public: * @param that The TimeZone object to be compared with. * @return True if the given TimeZone is not equal to this TimeZone; false * otherwise. - * @stable + * @stable ICU 2.0 */ UBool operator!=(const TimeZone& that) const {return !operator==(that);} @@ -363,7 +363,7 @@ public: * @param millis The reference date's milliseconds in day, UTT (NOT local time). * @param status Output param to filled in with a success or an error. * @return The offset in milliseconds to add to GMT to get local time. - * @stable + * @stable ICU 2.0 */ virtual int32_t getOffset(uint8_t era, int32_t year, int32_t month, int32_t day, uint8_t dayOfWeek, int32_t millis, UErrorCode& status) const = 0; @@ -389,7 +389,7 @@ public: * @param monthLength the length of the given month in days. * @param status Output param to filled in with a success or an error. * @return the offset to add *to* GMT to get local time. - * @stable + * @stable ICU 2.0 */ virtual int32_t getOffset(uint8_t era, int32_t year, int32_t month, int32_t day, uint8_t dayOfWeek, int32_t milliseconds, @@ -400,7 +400,7 @@ public: * to GMT to get local time, before taking daylight savings time into account). * * @param offsetMillis The new raw GMT offset for this time zone. - * @stable + * @stable ICU 2.0 */ virtual void setRawOffset(int32_t offsetMillis) = 0; @@ -409,7 +409,7 @@ public: * to GMT to get local time, before taking daylight savings time into account). * * @return The TimeZone's raw GMT offset. - * @stable + * @stable ICU 2.0 */ virtual int32_t getRawOffset(void) const = 0; @@ -418,7 +418,7 @@ public: * * @param ID Receives this TimeZone's ID. * @return A reference to 'ID' - * @stable + * @stable ICU 2.0 */ UnicodeString& getID(UnicodeString& ID) const; @@ -433,7 +433,7 @@ public: * Los Angeles. They're still those for New York. Only the ID has changed.) * * @param ID The new timezone ID. - * @stable + * @stable ICU 2.0 */ void setID(const UnicodeString& ID); @@ -455,7 +455,7 @@ public: * GMT[+-]hh:mm. * @param result the human-readable name of this time zone in the default locale. * @return A reference to 'result'. - * @stable + * @stable ICU 2.0 */ UnicodeString& getDisplayName(UnicodeString& result) const; @@ -470,7 +470,7 @@ public: * @param result the human-readable name of this time zone in the given locale * or in the default locale if the given locale is not recognized. * @return A reference to 'result'. - * @stable + * @stable ICU 2.0 */ UnicodeString& getDisplayName(const Locale& locale, UnicodeString& result) const; @@ -484,7 +484,7 @@ public: * @param style either LONG or SHORT * @param result the human-readable name of this time zone in the default locale. * @return A reference to 'result'. - * @stable + * @stable ICU 2.0 */ UnicodeString& getDisplayName(UBool daylight, EDisplayType style, UnicodeString& result) const; @@ -500,7 +500,7 @@ public: * @param result the human-readable name of this time zone in the given locale * or in the default locale if the given locale is not recognized. * @return A refence to 'result'. - * @stable + * @stable ICU 2.0 */ UnicodeString& getDisplayName(UBool daylight, EDisplayType style, const Locale& locale, UnicodeString& result) const; @@ -508,7 +508,7 @@ public: * Queries if this time zone uses daylight savings time. * @return true if this time zone uses daylight savings time, * false, otherwise. - * @stable + * @stable ICU 2.0 */ virtual UBool useDaylightTime(void) const = 0; @@ -533,7 +533,7 @@ public: * @param other the TimeZone object to be compared with * @return true if the given zone is the same as this one, * with the possible exception of the ID - * @stable + * @stable ICU 2.0 */ virtual UBool hasSameRules(const TimeZone& other) const; @@ -542,7 +542,7 @@ public: * the TimeZone object cloned. * * @return A new copy of this TimeZone object. - * @stable + * @stable ICU 2.0 */ virtual TimeZone* clone(void) const = 0; @@ -555,7 +555,7 @@ public: * . Derived::getStaticClassID()) ... * * @return The class ID for all objects of this class. - * @stable + * @stable ICU 2.0 */ static UClassID getStaticClassID(void) { return (UClassID)&fgClassID; } @@ -572,7 +572,7 @@ public: * * @return The class ID for this object. All objects of a given class have the * same class ID. Objects of other classes have different class IDs. - * @stable + * @stable ICU 2.0 */ virtual UClassID getDynamicClassID(void) const = 0; @@ -580,28 +580,28 @@ protected: /** * Default constructor. ID is initialized to the empty string. - * @stable + * @stable ICU 2.0 */ TimeZone(); /** * Construct a timezone with a given ID. * @param id a system time zone ID - * @stable + * @stable ICU 2.0 */ TimeZone(const UnicodeString &id); /** * Copy constructor. * @param source the object to be copied. - * @stable + * @stable ICU 2.0 */ TimeZone(const TimeZone& source); /** * Default assignment operator. * @param rigth the object to be copied. - * @stable + * @stable ICU 2.0 */ TimeZone& operator=(const TimeZone& right); diff --git a/icu4c/source/i18n/unicode/translit.h b/icu4c/source/i18n/unicode/translit.h index 1f9241e958..c2015bcbcd 100644 --- a/icu4c/source/i18n/unicode/translit.h +++ b/icu4c/source/i18n/unicode/translit.h @@ -230,7 +230,7 @@ class TransliteratorIDParser; * performance obtained by the default implementations in this class. * * @author Alan Liu - * @stable + * @stable ICU 2.0 */ class U_I18N_API Transliterator : public UObject { @@ -332,7 +332,7 @@ public: /** * Destructor. - * @stable + * @stable ICU 2.0 */ virtual ~Transliterator(); @@ -348,7 +348,7 @@ public: * * @return a copy of the object. * @see #registerInstance - * @stable + * @stable ICU 2.0 */ virtual Transliterator* clone() const { return 0; } @@ -365,7 +365,7 @@ public: * length, at [start, new-limit), where * new-limit is the return value. If the input offsets are out of bounds, * the returned value is -1 and the input string remains unchanged. - * @stable + * @stable ICU 2.0 */ virtual int32_t transliterate(Replaceable& text, int32_t start, int32_t limit) const; @@ -373,7 +373,7 @@ public: /** * Transliterates an entire string in place. Convenience method. * @param text the string to be transliterated - * @stable + * @stable ICU 2.0 */ virtual void transliterate(Replaceable& text) const; @@ -439,7 +439,7 @@ public: * @exception IllegalArgumentException if index * is invalid * @see UTransPosition - * @stable + * @stable ICU 2.0 */ virtual void transliterate(Replaceable& text, UTransPosition& index, const UnicodeString& insertion, @@ -460,7 +460,7 @@ public: * index.limit. * @param status Output param to filled in with a success or an error. * @see #transliterate(Replaceable, UTransPosition, UnicodeString) - * @stable + * @stable ICU 2.0 */ virtual void transliterate(Replaceable& text, UTransPosition& index, UChar32 insertion, @@ -477,7 +477,7 @@ public: * #transliterate(Replaceable, UTransPosition, UnicodeString)}. * @param status Output param to filled in with a success or an error. * @see #transliterate(Replaceable, int[], String) - * @stable + * @stable ICU 2.0 */ virtual void transliterate(Replaceable& text, UTransPosition& index, UErrorCode& status) const; @@ -491,7 +491,7 @@ public: * untransliterated text. * @param index the array of indices previously passed to {@link * #transliterate()} - * @stable + * @stable ICU 2.0 */ virtual void finishTransliteration(Replaceable& text, UTransPosition& index) const; @@ -666,7 +666,7 @@ public: * * @return The maximum number of preceding context characters this * transliterator needs to examine - * @stable + * @stable ICU 2.0 */ int32_t getMaximumContextLength(void) const; @@ -689,7 +689,7 @@ public: * @see #registerInstance * @see #registerClass * @see #getAvailableIDs - * @stable + * @stable ICU 2.0 */ virtual const UnicodeString& getID(void) const; @@ -700,7 +700,7 @@ public: * @param ID the string identifier for this transliterator * @param result Output param to receive the display name * @return A reference to 'result'. - * @stable + * @stable ICU 2.0 */ static UnicodeString& getDisplayName(const UnicodeString& ID, UnicodeString& result); @@ -724,7 +724,7 @@ public: * localized. * @param result Output param to receive the display name * @return A reference to 'result'. - * @stable + * @stable ICU 2.0 */ static UnicodeString& getDisplayName(const UnicodeString& ID, const Locale& inLocale, @@ -735,7 +735,7 @@ public: * if this transliterator uses no filter. * @return the filter used by this transliterator, or NULL * if this transliterator uses no filter. - * @stable + * @stable ICU 2.0 */ const UnicodeFilter* getFilter(void) const; @@ -770,7 +770,7 @@ public: * multiple threads. The filter should not be changed by one * thread while another thread may be transliterating. * @param adoptedFilter the new filter to be adopted. - * @stable + * @stable ICU 2.0 */ void adoptFilter(UnicodeFilter* adoptedFilter); #endif @@ -792,7 +792,7 @@ public: * exact, of this transliterator, or null if no such * transliterator is registered. * @see #registerInstance - * @stable + * @stable ICU 2.0 */ Transliterator* createInverse(UErrorCode& status) const; @@ -810,7 +810,7 @@ public: * @see #registerInstance * @see #getAvailableIDs * @see #getID - * @stable + * @stable ICU 2.0 */ static Transliterator* createInstance(const UnicodeString& ID, UTransDirection dir, @@ -825,7 +825,7 @@ public: * @param dir either FORWARD or REVERSE. * @param status Output param to filled in with a success or an error. * @return A Transliterator object with the given ID - * @stable + * @stable ICU 2.0 */ static Transliterator* createInstance(const UnicodeString& ID, UTransDirection dir, @@ -843,7 +843,7 @@ public: * @param parseError Struct to recieve information on position * of error if an error is encountered * @param status Output param set to success/failure code. - * @stable + * @stable ICU 2.0 */ static Transliterator* createFromRules(const UnicodeString& ID, const UnicodeString& rules, @@ -860,7 +860,7 @@ public: * character to their hex escape representations, \uxxxx or * \Uxxxxxxxx. Unprintable characters are those other than * U+000A, U+0020..U+007E. - * @stable + * @stable ICU 2.0 */ virtual UnicodeString& toRules(UnicodeString& result, UBool escapeUnprintable) const; @@ -921,7 +921,7 @@ public: * @param context a context pointer that will be stored and * later passed to the factory function when an ID matching * the registration ID is being instantiated with this factory. - * @stable + * @stable ICU 2.0 */ static void registerFactory(const UnicodeString& id, Factory factory, @@ -942,7 +942,7 @@ public: * @see #createInstance * @see #registerClass * @see #unregister - * @stable + * @stable ICU 2.0 */ static void registerInstance(Transliterator* adoptedObj); @@ -1016,7 +1016,7 @@ public: * ID, or null if none was * @see #registerInstance * @see #registerClass - * @stable + * @stable ICU 2.0 */ static void unregister(const UnicodeString& ID); @@ -1027,7 +1027,7 @@ public: * To retrieve the actual IDs, call getAvailableID(i) with * i from 0 to countAvailableIDs() - 1. * @return the number of IDs currently registered with the system. - * @stable + * @stable ICU 2.0 */ static int32_t countAvailableIDs(void); @@ -1039,14 +1039,14 @@ public: * @return the index-th available ID. index must be between 0 * and countAvailableIDs() - 1, inclusive. If index is out of * range, the result of getAvailableID(0) is returned. - * @stable + * @stable ICU 2.0 */ static const UnicodeString& getAvailableID(int32_t index); /** * Return the number of registered source specifiers. * @return the number of registered source specifiers. - * @stable + * @stable ICU 2.0 */ static int32_t countAvailableSources(void); @@ -1057,7 +1057,7 @@ public: * @param result fill-in paramter to receive the source specifier. * If index is out of range, result will be empty. * @return reference to result - * @stable + * @stable ICU 2.0 */ static UnicodeString& getAvailableSource(int32_t index, UnicodeString& result); @@ -1068,7 +1068,7 @@ public: * @param source the given source specifier. * @return the number of registered target specifiers for a given * source specifier. - * @stable + * @stable ICU 2.0 */ static int32_t countAvailableTargets(const UnicodeString& source); @@ -1081,7 +1081,7 @@ public: * If source is invalid or if index is out of range, result will * be empty. * @return reference to result - * @stable + * @stable ICU 2.0 */ static UnicodeString& getAvailableTarget(int32_t index, const UnicodeString& source, @@ -1092,7 +1092,7 @@ public: * source-target pair. * @param source the source specifiers. * @param target the target specifiers. - * @stable + * @stable ICU 2.0 */ static int32_t countAvailableVariants(const UnicodeString& source, const UnicodeString& target); @@ -1108,7 +1108,7 @@ public: * specifier. If source is invalid or if target is invalid or if * index is out of range, result will be empty. * @return reference to result - * @stable + * @stable ICU 2.0 */ static UnicodeString& getAvailableVariant(int32_t index, const UnicodeString& source, @@ -1170,7 +1170,7 @@ public: * . Derived::getStaticClassID()) ... * * @return The class ID for all objects of this class. - * @stable + * @stable ICU 2.0 */ static UClassID getStaticClassID(void) { return (UClassID)&fgClassID; } @@ -1195,7 +1195,7 @@ public: * @return The class ID for this object. All objects of a given * class have the same class ID. Objects of other classes have * different class IDs. - * @stable + * @stable ICU 2.0 */ virtual UClassID getDynamicClassID(void) const { return getStaticClassID(); }; diff --git a/icu4c/source/i18n/unicode/ucal.h b/icu4c/source/i18n/unicode/ucal.h index c65cb99968..f1c2818a4c 100644 --- a/icu4c/source/i18n/unicode/ucal.h +++ b/icu4c/source/i18n/unicode/ucal.h @@ -134,7 +134,7 @@ * For example, subtracting 5 days from the date September 12, 1996 * results in September 7, 1996. * - * @stable + * @stable ICU 2.0 */ /** A calendar. @@ -144,7 +144,7 @@ typedef void* UCalendar; /** Possible types of UCalendars - * @stable + * @stable ICU 2.0 */ enum UCalendarType { /** A traditional calendar for the locale */ @@ -157,7 +157,7 @@ enum UCalendarType { typedef enum UCalendarType UCalendarType; /** Possible fields in a UCalendar - * @stable + * @stable ICU 2.0 */ enum UCalendarDateFields { /** Era field */ @@ -210,7 +210,7 @@ typedef enum UCalendarDateFields UCalendarDateFields; * this. For instance, in US locale, first-day-of-week is set to 1, i.e., UCAL_SUNDAY. */ /** Possible days of the week in a UCalendar - * @stable + * @stable ICU 2.0 */ enum UCalendarDaysOfWeek { /** Sunday */ @@ -233,7 +233,7 @@ enum UCalendarDaysOfWeek { typedef enum UCalendarDaysOfWeek UCalendarDaysOfWeek; /** Possible months in a UCalendar. Note: Calendar month is 0-based. - * @stable + * @stable ICU 2.0 */ enum UCalendarMonths { /** January */ @@ -268,7 +268,7 @@ enum UCalendarMonths { typedef enum UCalendarMonths UCalendarMonths; /** Possible AM/PM values in a UCalendar - * @stable + * @stable ICU 2.0 */ enum UCalendarAMPMs { /** AM */ @@ -324,7 +324,7 @@ ucal_countAvailableTZIDs(int32_t rawOffset); * Get the current date and time. * The value returned is represented as milliseconds from the epoch. * @return The current date and time. -* @stable +* @stable ICU 2.0 */ U_CAPI UDate U_EXPORT2 ucal_getNow(void); @@ -339,7 +339,7 @@ ucal_getNow(void); * @param type The type of UCalendar to open. * @param status A pointer to an UErrorCode to receive any errors * @return A pointer to a UCalendar, or 0 if an error occurred. -* @stable +* @stable ICU 2.0 */ U_CAPI UCalendar* U_EXPORT2 ucal_open( const UChar* zoneID, @@ -352,7 +352,7 @@ ucal_open( const UChar* zoneID, * Close a UCalendar. * Once closed, a UCalendar may no longer be used. * @param cal The UCalendar to close. -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucal_close(UCalendar *cal); @@ -364,7 +364,7 @@ ucal_close(UCalendar *cal); * @param zoneID The desired TimeZone ID. If 0, use the default time zone. * @param len The length of zoneID, or -1 if null-terminated. * @param status A pointer to an UErrorCode to receive any errors. -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucal_setTimeZone( UCalendar* cal, @@ -373,7 +373,7 @@ ucal_setTimeZone( UCalendar* cal, UErrorCode *status); /** Possible formats for a UCalendar's display name - * @stable + * @stable ICU 2.0 */ enum UCalendarDisplayNameType { /** Standard display name */ @@ -400,7 +400,7 @@ typedef enum UCalendarDisplayNameType UCalendarDisplayNameType; * @param resultLength The maximum size of result. * @param status A pointer to an UErrorCode to receive any errors * @return The total buffer size needed; if greater than resultLength, the output was truncated. -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucal_getTimeZoneDisplayName( const UCalendar* cal, @@ -416,7 +416,7 @@ ucal_getTimeZoneDisplayName( const UCalendar* cal, * @param cal The UCalendar to query. * @param status A pointer to an UErrorCode to receive any errors * @return TRUE if cal is currently in daylight savings time, FALSE otherwise -* @stable +* @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 ucal_inDaylightTime( const UCalendar* cal, @@ -446,7 +446,7 @@ typedef enum UCalendarAttribute UCalendarAttribute; * or UCAL_MINIMAL_DAYS_IN_FIRST_WEEK * @return The value of attr. * @see ucal_setAttribute -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucal_getAttribute( const UCalendar* cal, @@ -461,7 +461,7 @@ ucal_getAttribute( const UCalendar* cal, * or UCAL_MINIMAL_DAYS_IN_FIRST_WEEK * @param newValue The new value of attr. * @see ucal_getAttribute -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucal_setAttribute( UCalendar* cal, @@ -475,7 +475,7 @@ ucal_setAttribute( UCalendar* cal, * @param index The index of the desired locale. * @return A locale for which calendars are available, or 0 if none. * @see ucal_countAvailable -* @stable +* @stable ICU 2.0 */ U_CAPI const char* U_EXPORT2 ucal_getAvailable(int32_t index); @@ -486,7 +486,7 @@ ucal_getAvailable(int32_t index); * calls to \Ref{ucal_getAvailable}. * @return The number of locales for which calendars are available. * @see ucal_getAvailable -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucal_countAvailable(void); @@ -500,7 +500,7 @@ ucal_countAvailable(void); * @see ucal_setMillis * @see ucal_setDate * @see ucal_setDateTime -* @stable +* @stable ICU 2.0 */ U_CAPI UDate U_EXPORT2 ucal_getMillis( const UCalendar* cal, @@ -515,7 +515,7 @@ ucal_getMillis( const UCalendar* cal, * @see ucal_getMillis * @see ucal_setDate * @see ucal_setDateTime -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucal_setMillis( UCalendar* cal, @@ -534,7 +534,7 @@ ucal_setMillis( UCalendar* cal, * @see ucal_getMillis * @see ucal_setMillis * @see ucal_setDateTime -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucal_setDate( UCalendar* cal, @@ -558,7 +558,7 @@ ucal_setDate( UCalendar* cal, * @see ucal_getMillis * @see ucal_setMillis * @see ucal_setDate -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucal_setDateTime( UCalendar* cal, @@ -577,7 +577,7 @@ ucal_setDateTime( UCalendar* cal, * @param cal1 The first of the UCalendars to compare. * @param cal2 The second of the UCalendars to compare. * @return TRUE if cal1 and cal2 are equivalent, FALSE otherwise. - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 ucal_equivalentTo(const UCalendar* cal1, @@ -596,7 +596,7 @@ ucal_equivalentTo(const UCalendar* cal1, * to preserve the magnitude of the change. * @param status A pointer to an UErrorCode to receive any errors * @see ucal_roll -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucal_add( UCalendar* cal, @@ -617,7 +617,7 @@ ucal_add( UCalendar* cal, * value. * @param status A pointer to an UErrorCode to receive any errors * @see ucal_add -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucal_roll( UCalendar* cal, @@ -639,7 +639,7 @@ ucal_roll( UCalendar* cal, * @see ucal_isSet * @see ucal_clearField * @see ucal_clear -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucal_get( const UCalendar* cal, @@ -659,7 +659,7 @@ ucal_get( const UCalendar* cal, * @see ucal_isSet * @see ucal_clearField * @see ucal_clear -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucal_set( UCalendar* cal, @@ -679,7 +679,7 @@ ucal_set( UCalendar* cal, * @see ucal_set * @see ucal_clearField * @see ucal_clear -* @stable +* @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 ucal_isSet( const UCalendar* cal, @@ -697,7 +697,7 @@ ucal_isSet( const UCalendar* cal, * @see ucal_set * @see ucal_isSet * @see ucal_clear -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucal_clearField( UCalendar* cal, @@ -711,13 +711,13 @@ ucal_clearField( UCalendar* cal, * @see ucal_set * @see ucal_isSet * @see ucal_clearField -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucal_clear(UCalendar* calendar); /** Possible limit values for a UCalendar - * @stable + * @stable ICU 2.0 */ enum UCalendarLimitType { /** Minimum value */ @@ -749,7 +749,7 @@ typedef enum UCalendarLimitType UCalendarLimitType; * UCAL_LEAST_MAXIMUM, UCAL_ACTUAL_MINIMUM, UCAL_ACTUAL_MAXIMUM * @param status A pointer to an UErrorCode to receive any errors. * @return The requested value. -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucal_getLimit( const UCalendar* cal, diff --git a/icu4c/source/i18n/unicode/ucol.h b/icu4c/source/i18n/unicode/ucol.h index f26cfa2d3d..ed42ebca70 100644 --- a/icu4c/source/i18n/unicode/ucol.h +++ b/icu4c/source/i18n/unicode/ucol.h @@ -244,7 +244,7 @@ typedef enum { * @see ucol_openRules * @see ucol_safeClone * @see ucol_close - * @stable + * @stable ICU 2.0 */ U_CAPI UCollator* U_EXPORT2 ucol_open(const char *loc, UErrorCode *status); @@ -272,7 +272,7 @@ ucol_open(const char *loc, UErrorCode *status); * @see ucol_open * @see ucol_safeClone * @see ucol_close - * @stable + * @stable ICU 2.0 */ U_CAPI UCollator* U_EXPORT2 ucol_openRules( const UChar *rules, @@ -290,7 +290,7 @@ ucol_openRules( const UChar *rules, * @see ucol_open * @see ucol_openRules * @see ucol_safeClone - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucol_close(UCollator *coll); @@ -308,7 +308,7 @@ ucol_close(UCollator *coll); * @see ucol_greater * @see ucol_greaterOrEqual * @see ucol_equal - * @stable + * @stable ICU 2.0 */ U_CAPI UCollationResult U_EXPORT2 ucol_strcoll( const UCollator *coll, @@ -329,7 +329,7 @@ ucol_strcoll( const UCollator *coll, * @see ucol_strcoll * @see ucol_greaterOrEqual * @see ucol_equal - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 ucol_greater(const UCollator *coll, @@ -348,7 +348,7 @@ ucol_greater(const UCollator *coll, * @see ucol_strcoll * @see ucol_greater * @see ucol_equal - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 ucol_greaterOrEqual(const UCollator *coll, @@ -367,7 +367,7 @@ ucol_greaterOrEqual(const UCollator *coll, * @see ucol_strcoll * @see ucol_greater * @see ucol_greaterOrEqual - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 ucol_equal(const UCollator *coll, @@ -381,7 +381,7 @@ ucol_equal(const UCollator *coll, * @return The collation strength; one of UCOL_PRIMARY, UCOL_SECONDARY, * UCOL_TERTIARY, UCOL_QUATERNARY, UCOL_IDENTICAL * @see ucol_setStrength - * @stable + * @stable ICU 2.0 */ U_CAPI UCollationStrength U_EXPORT2 ucol_getStrength(const UCollator *coll); @@ -393,7 +393,7 @@ ucol_getStrength(const UCollator *coll); * @param strength The desired collation strength; one of UCOL_PRIMARY, * UCOL_SECONDARY, UCOL_TERTIARY, UCOL_QUATERNARY, UCOL_IDENTICAL, UCOL_DEFAULT * @see ucol_getStrength - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucol_setStrength(UCollator *coll, @@ -409,7 +409,7 @@ ucol_setStrength(UCollator *coll, * @param status A pointer to an UErrorCode to receive any errors * @return The total buffer size needed; if greater than resultLength, * the output was truncated. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucol_getDisplayName( const char *objLoc, @@ -425,7 +425,7 @@ ucol_getDisplayName( const char *objLoc, * @param index The index of the desired locale. * @return A locale for which collation rules are available, or 0 if none. * @see ucol_countAvailable - * @stable + * @stable ICU 2.0 */ U_CAPI const char* U_EXPORT2 ucol_getAvailable(int32_t index); @@ -436,7 +436,7 @@ ucol_getAvailable(int32_t index); * calls to \Ref{ucol_getAvailable}. * @return The number of locales for which collation rules are available. * @see ucol_getAvailable - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucol_countAvailable(void); @@ -447,7 +447,7 @@ ucol_countAvailable(void); * @param coll The UCollator to query. * @param length * @return The collation rules. - * @stable + * @stable ICU 2.0 */ U_CAPI const UChar* U_EXPORT2 ucol_getRules( const UCollator *coll, @@ -463,7 +463,7 @@ ucol_getRules( const UCollator *coll, * @param resultLength The maximum size of result. * @return The size needed to fully store the sort key.. * @see ucol_keyHashCode - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucol_getSortKey(const UCollator *coll, @@ -537,7 +537,7 @@ ucol_getBound(const uint8_t *source, * Gets the version information for a Collator. * @param coll The UCollator to query. * @param info the version # information, the result will be filled in - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucol_getVersion(const UCollator* coll, UVersionInfo info); @@ -561,7 +561,7 @@ ucol_getVersion(const UCollator* coll, UVersionInfo info); * @param destCapacity size of the buffer for the result * @return size of the result. If the buffer is big enough size is always * src1Length+src2Length-1 - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucol_mergeSortkeys(const uint8_t *src1, int32_t src1Length, @@ -577,7 +577,7 @@ ucol_mergeSortkeys(const uint8_t *src1, int32_t src1Length, * @see UColAttribute * @see UColAttributeValue * @see ucol_getAttribute - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucol_setAttribute(UCollator *coll, UColAttribute attr, UColAttributeValue value, UErrorCode *status); @@ -591,7 +591,7 @@ ucol_setAttribute(UCollator *coll, UColAttribute attr, UColAttributeValue value, * @see UColAttribute * @see UColAttributeValue * @see ucol_setAttribute - * @stable + * @stable ICU 2.0 */ U_CAPI UColAttributeValue U_EXPORT2 ucol_getAttribute(const UCollator *coll, UColAttribute attr, UErrorCode *status); @@ -613,7 +613,7 @@ ucol_getAttribute(const UCollator *coll, UColAttribute attr, UErrorCode *status) * Lower 16 bits are undefined * @see ucol_getVariableTop * @see ucol_restoreVariableTop - * @stable + * @stable ICU 2.0 */ U_CAPI uint32_t U_EXPORT2 ucol_setVariableTop(UCollator *coll, @@ -629,7 +629,7 @@ ucol_setVariableTop(UCollator *coll, * @return the variable top value of a Collator. * @see ucol_setVariableTop * @see ucol_restoreVariableTop - * @stable + * @stable ICU 2.0 */ U_CAPI uint32_t U_EXPORT2 ucol_getVariableTop(const UCollator *coll, UErrorCode *status); @@ -642,7 +642,7 @@ U_CAPI uint32_t U_EXPORT2 ucol_getVariableTop(const UCollator *coll, UErrorCode * @param status error code (not changed by function) * @see ucol_getVariableTop * @see ucol_setVariableTop - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucol_restoreVariableTop(UCollator *coll, const uint32_t varTop, UErrorCode *status); @@ -667,7 +667,7 @@ ucol_restoreVariableTop(UCollator *coll, const uint32_t varTop, UErrorCode *stat * @see ucol_open * @see ucol_openRules * @see ucol_close - * @stable + * @stable ICU 2.0 */ U_CAPI UCollator* U_EXPORT2 ucol_safeClone(const UCollator *coll, @@ -687,7 +687,7 @@ ucol_safeClone(const UCollator *coll, * @param buffer buffer to store the result in. If NULL, you'll get no rules. * @param bufferLen lenght of buffer to store rules in. If less then needed you'll get only the part that fits in. * @return current rules - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucol_getRulesEx(const UCollator *coll, UColRuleOption delta, UChar *buffer, int32_t bufferLen); diff --git a/icu4c/source/i18n/unicode/ucoleitr.h b/icu4c/source/i18n/unicode/ucoleitr.h index de03380b9a..bd494848c5 100644 --- a/icu4c/source/i18n/unicode/ucoleitr.h +++ b/icu4c/source/i18n/unicode/ucoleitr.h @@ -103,7 +103,7 @@ typedef struct UCollationElements UCollationElements; * @param textLength The number of characters in text, or -1 if null-terminated * @param status A pointer to an UErrorCode to receive any errors. * @return a struct containing collation element information - * @stable + * @stable ICU 2.0 */ U_CAPI UCollationElements* U_EXPORT2 ucol_openElements(const UCollator *coll, @@ -116,7 +116,7 @@ ucol_openElements(const UCollator *coll, * @param key the given key. * @param length the size of the key array. * @return the hash code. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucol_keyHashCode(const uint8_t* key, int32_t length); @@ -125,7 +125,7 @@ ucol_keyHashCode(const uint8_t* key, int32_t length); * Close a UCollationElements. * Once closed, a UCollationElements may no longer be used. * @param elems The UCollationElements to close. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucol_closeElements(UCollationElements *elems); @@ -137,7 +137,7 @@ ucol_closeElements(UCollationElements *elems); * @param elems The UCollationElements to reset. * @see ucol_next * @see ucol_previous - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucol_reset(UCollationElements *elems); @@ -149,7 +149,7 @@ ucol_reset(UCollationElements *elems); * @param status A pointer to an UErrorCode to receive any errors. * @return The next collation elements ordering, otherwise returns NULLORDER * if an error has occured or if the end of string has been reached - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucol_next(UCollationElements *elems, UErrorCode *status); @@ -168,7 +168,7 @@ ucol_next(UCollationElements *elems, UErrorCode *status); * @return The previous collation elements ordering, otherwise returns * NULLORDER if an error has occured or if the start of string has * been reached. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucol_previous(UCollationElements *elems, UErrorCode *status); @@ -182,7 +182,7 @@ ucol_previous(UCollationElements *elems, UErrorCode *status); * @return maximum size of the expansion sequences ending with the collation * element or 1 if collation element does not occur at the end of any * expansion sequence - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucol_getMaxExpansion(const UCollationElements *elems, int32_t order); @@ -197,7 +197,7 @@ ucol_getMaxExpansion(const UCollationElements *elems, int32_t order); * @param textLength The length of text, or -1 if null-terminated. * @param status A pointer to an UErrorCode to receive any errors. * @see ucol_getText - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucol_setText( UCollationElements *elems, @@ -212,7 +212,7 @@ ucol_setText( UCollationElements *elems, * @param elems The UCollationElements to query. * @return The offset of the current source character. * @see ucol_setOffset - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucol_getOffset(const UCollationElements *elems); @@ -227,7 +227,7 @@ ucol_getOffset(const UCollationElements *elems); * @param offset The desired character offset. * @param status A pointer to an UErrorCode to receive any errors. * @see ucol_getOffset - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucol_setOffset(UCollationElements *elems, diff --git a/icu4c/source/i18n/unicode/udat.h b/icu4c/source/i18n/unicode/udat.h index 75d9b613fa..7bf6a8178b 100644 --- a/icu4c/source/i18n/unicode/udat.h +++ b/icu4c/source/i18n/unicode/udat.h @@ -171,7 +171,7 @@ typedef enum UDateFormatStyle { * @param status A pointer to an UErrorCode to receive any errors * @return A pointer to a UDateFormat to use for formatting dates and times, or 0 if * an error occurred. - * @stable + * @stable ICU 2.0 */ U_CAPI UDateFormat* U_EXPORT2 udat_open(UDateFormatStyle timeStyle, @@ -188,7 +188,7 @@ udat_open(UDateFormatStyle timeStyle, * Close a UDateFormat. * Once closed, a UDateFormat may no longer be used. * @param fmt The formatter to close. -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 udat_close(UDateFormat* format); @@ -199,7 +199,7 @@ udat_close(UDateFormat* format); * @param fmt The format to copy * @param status A pointer to an UErrorCode to receive any errors. * @return A pointer to a UDateFormat identical to fmt. - * @stable + * @stable ICU 2.0 */ U_CAPI UDateFormat* U_EXPORT2 udat_clone(const UDateFormat *fmt, @@ -222,7 +222,7 @@ udat_clone(const UDateFormat *fmt, * @return The total buffer size needed; if greater than resultLength, the output was truncated. * @see udat_parse * @see UFieldPosition -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 udat_format( const UDateFormat* format, @@ -244,7 +244,7 @@ udat_format( const UDateFormat* format, * @param status A pointer to an UErrorCode to receive any errors * @return The value of the parsed date/time * @see udat_format -* @stable +* @stable ICU 2.0 */ U_CAPI UDate U_EXPORT2 udat_parse( const UDateFormat* format, @@ -265,7 +265,7 @@ udat_parse( const UDateFormat* format, * to begin parsing. If not 0, on output the offset at which parsing ended. * @param status A pointer to an UErrorCode to receive any errors * @see udat_format -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 udat_parseCalendar(const UDateFormat* format, @@ -282,7 +282,7 @@ udat_parseCalendar(const UDateFormat* format, * @param fmt The formatter to query * @return TRUE if fmt is set to perform lenient parsing, FALSE otherwise. * @see udat_setLenient -* @stable +* @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 udat_isLenient(const UDateFormat* fmt); @@ -294,7 +294,7 @@ udat_isLenient(const UDateFormat* fmt); * @param fmt The formatter to set * @param isLenient TRUE if fmt should perform lenient parsing, FALSE otherwise. * @see dat_isLenient -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 udat_setLenient( UDateFormat* fmt, @@ -307,7 +307,7 @@ udat_setLenient( UDateFormat* fmt, * @param fmt The formatter to query. * @return A pointer to the UCalendar used by fmt. * @see udat_setCalendar -* @stable +* @stable ICU 2.0 */ U_CAPI const UCalendar* U_EXPORT2 udat_getCalendar(const UDateFormat* fmt); @@ -319,7 +319,7 @@ udat_getCalendar(const UDateFormat* fmt); * @param fmt The formatter to set. * @param calendarToSet A pointer to an UCalendar to be used by fmt. * @see udat_setCalendar -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 udat_setCalendar( UDateFormat* fmt, @@ -332,7 +332,7 @@ udat_setCalendar( UDateFormat* fmt, * @param fmt The formatter to query. * @return A pointer to the UNumberFormat used by fmt to format numbers. * @see udat_setNumberFormat -* @stable +* @stable ICU 2.0 */ U_CAPI const UNumberFormat* U_EXPORT2 udat_getNumberFormat(const UDateFormat* fmt); @@ -344,7 +344,7 @@ udat_getNumberFormat(const UDateFormat* fmt); * @param fmt The formatter to set. * @param numberFormatToSet A pointer to the UNumberFormat to be used by fmt to format numbers. * @see udat_getNumberFormat -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 udat_setNumberFormat( UDateFormat* fmt, @@ -357,7 +357,7 @@ udat_setNumberFormat( UDateFormat* fmt, * @param index The index of the desired locale. * @return A locale for which date/time formatting patterns are available, or 0 if none. * @see udat_countAvailable -* @stable +* @stable ICU 2.0 */ U_CAPI const char* U_EXPORT2 udat_getAvailable(int32_t index); @@ -368,7 +368,7 @@ udat_getAvailable(int32_t index); * calls to \Ref{udat_getAvailable}. * @return The number of locales for which date/time formatting patterns are available. * @see udat_getAvailable -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 udat_countAvailable(void); @@ -381,7 +381,7 @@ udat_countAvailable(void); * @param status A pointer to an UErrorCode to receive any errors * @return The year relative to which all 2-digit years are interpreted. * @see udat_Set2DigitYearStart -* @stable +* @stable ICU 2.0 */ U_CAPI UDate U_EXPORT2 udat_get2DigitYearStart( const UDateFormat *fmt, @@ -395,7 +395,7 @@ udat_get2DigitYearStart( const UDateFormat *fmt, * @param d The year relative to which all 2-digit years will be interpreted. * @param status A pointer to an UErrorCode to receive any errors * @see udat_Set2DigitYearStart -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 udat_set2DigitYearStart( UDateFormat *fmt, @@ -412,7 +412,7 @@ udat_set2DigitYearStart( UDateFormat *fmt, * @param status A pointer to an UErrorCode to receive any errors * @return The total buffer size needed; if greater than resultLength, the output was truncated. * @see udat_applyPattern -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 udat_toPattern( const UDateFormat *fmt, @@ -429,7 +429,7 @@ udat_toPattern( const UDateFormat *fmt, * @param pattern The new pattern * @param patternLength The length of pattern, or -1 if null-terminated. * @see udat_toPattern -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 udat_applyPattern( UDateFormat *format, @@ -475,7 +475,7 @@ typedef struct UDateFormatSymbols UDateFormatSymbols; * @return The total buffer size needed; if greater than resultLength, the output was truncated. * @see udat_countSymbols * @see udat_setSymbols -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 udat_getSymbols(const UDateFormat *fmt, @@ -495,7 +495,7 @@ udat_getSymbols(const UDateFormat *fmt, * @return The number of symbols of type type. * @see udat_getSymbols * @see udat_setSymbols -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 udat_countSymbols( const UDateFormat *fmt, @@ -514,7 +514,7 @@ udat_countSymbols( const UDateFormat *fmt, * @param status A pointer to an UErrorCode to receive any errors * @see udat_getSymbols * @see udat_countSymbols -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 udat_setSymbols( UDateFormat *format, diff --git a/icu4c/source/i18n/unicode/umsg.h b/icu4c/source/i18n/unicode/umsg.h index 1f806b540d..81344ef203 100644 --- a/icu4c/source/i18n/unicode/umsg.h +++ b/icu4c/source/i18n/unicode/umsg.h @@ -197,7 +197,7 @@ * @return The total buffer size needed; if greater than resultLength, the * output was truncated. * @see u_parseMessage - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_formatMessage(const char *locale, @@ -248,7 +248,7 @@ u_vformatMessage( const char *locale, * @param ... A variable-length argument list containing the arguments * specified in pattern. * @see u_formatMessage - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 u_parseMessage( const char *locale, @@ -425,7 +425,7 @@ umsg_open( const UChar *pattern, * Close a UMessageFormat. * Once closed, a UMessageFormat may no longer be used. * @param format The formatter to close. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 umsg_close(UMessageFormat* format); @@ -436,7 +436,7 @@ umsg_close(UMessageFormat* format); * @param fmt The formatter to copy * @param status A pointer to an UErrorCode to receive any errors. * @return A pointer to a UDateFormat identical to fmt. - * @stable + * @stable ICU 2.0 */ U_CAPI UMessageFormat U_EXPORT2 umsg_clone(const UMessageFormat *fmt, @@ -457,7 +457,7 @@ umsg_setLocale(UMessageFormat *fmt, * format information. * @param fmt The formatter to querry * @return the locale. - * @stable + * @stable ICU 2.0 */ U_CAPI const char* U_EXPORT2 umsg_getLocale(UMessageFormat *fmt); @@ -511,7 +511,7 @@ umsg_toPattern(UMessageFormat *fmt, * specified in pattern. * @return The total buffer size needed; if greater than resultLength, * the output was truncated. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 umsg_format( UMessageFormat *fmt, @@ -553,7 +553,7 @@ umsg_vformat( UMessageFormat *fmt, * @param status A pointer to an UErrorCode to receive any errors * @param ... A variable-length argument list containing the arguments * specified in pattern. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 umsg_parse( UMessageFormat *fmt, diff --git a/icu4c/source/i18n/unicode/unitohex.h b/icu4c/source/i18n/unicode/unitohex.h index 4fa7c7b90c..c572fd4447 100644 --- a/icu4c/source/i18n/unicode/unitohex.h +++ b/icu4c/source/i18n/unicode/unitohex.h @@ -145,7 +145,7 @@ public: /** * Assignment operator. - * @stable + * @stable ICU 2.0 */ UnicodeToHexTransliterator& operator=(const UnicodeToHexTransliterator&); diff --git a/icu4c/source/i18n/unicode/unum.h b/icu4c/source/i18n/unicode/unum.h index 48ab25a71f..13ed05cca0 100644 --- a/icu4c/source/i18n/unicode/unum.h +++ b/icu4c/source/i18n/unicode/unum.h @@ -168,7 +168,7 @@ typedef enum UNumberFormatPadPosition { * @return A pointer to a UNumberFormat to use for formatting numbers, or 0 if * an error occurred. * @see unum_open -* @stable +* @stable ICU 2.0 */ U_CAPI UNumberFormat* U_EXPORT2 unum_open( UNumberFormatStyle style, @@ -183,7 +183,7 @@ unum_open( UNumberFormatStyle style, * Close a UNumberFormat. * Once closed, a UNumberFormat may no longer be used. * @param fmt The formatter to close. -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 unum_close(UNumberFormat* fmt); @@ -194,7 +194,7 @@ unum_close(UNumberFormat* fmt); * @param fmt The format to copy * @param status A pointer to an UErrorCode to receive any errors. * @return A pointer to a UNumberFormat identical to fmt. - * @stable + * @stable ICU 2.0 */ U_CAPI UNumberFormat* U_EXPORT2 unum_clone(const UNumberFormat *fmt, @@ -217,7 +217,7 @@ unum_clone(const UNumberFormat *fmt, * @see unum_parse * @see unum_parseDouble * @see UFieldPosition -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 unum_format( const UNumberFormat* fmt, @@ -244,7 +244,7 @@ unum_format( const UNumberFormat* fmt, * @see unum_parse * @see unum_parseDouble * @see UFieldPosition -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 unum_formatDouble( const UNumberFormat* fmt, @@ -267,7 +267,7 @@ unum_formatDouble( const UNumberFormat* fmt, * @see unum_parseDouble * @see unum_format * @see unum_formatDouble -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 unum_parse( const UNumberFormat* fmt, @@ -289,7 +289,7 @@ unum_parse( const UNumberFormat* fmt, * @see unum_parse * @see unum_format * @see unum_formatDouble -* @stable +* @stable ICU 2.0 */ U_CAPI double U_EXPORT2 unum_parseDouble( const UNumberFormat* fmt, @@ -326,7 +326,7 @@ unum_applyPattern( UNumberFormat *format, * @param index The index of the desired locale. * @return A locale for which number formatting patterns are available, or 0 if none. * @see unum_countAvailable -* @stable +* @stable ICU 2.0 */ U_CAPI const char* U_EXPORT2 unum_getAvailable(int32_t index); @@ -337,7 +337,7 @@ unum_getAvailable(int32_t index); * calls to \Ref{unum_getAvailable}. * @return The number of locales for which number formatting patterns are available. * @see unum_getAvailable -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 unum_countAvailable(void); @@ -392,7 +392,7 @@ typedef enum UNumberFormatAttribute { * @see unum_setDoubleAttribute * @see unum_getTextAttribute * @see unum_setTextAttribute -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 unum_getAttribute(const UNumberFormat* fmt, @@ -412,7 +412,7 @@ unum_getAttribute(const UNumberFormat* fmt, * @see unum_setDoubleAttribute * @see unum_getTextAttribute * @see unum_setTextAttribute -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 unum_setAttribute( UNumberFormat* fmt, @@ -431,7 +431,7 @@ unum_setAttribute( UNumberFormat* fmt, * @see unum_setDoubleAttribute * @see unum_getTextAttribute * @see unum_setTextAttribute -* @stable +* @stable ICU 2.0 */ U_CAPI double U_EXPORT2 unum_getDoubleAttribute(const UNumberFormat* fmt, @@ -448,7 +448,7 @@ unum_getDoubleAttribute(const UNumberFormat* fmt, * @see unum_getDoubleAttribute * @see unum_getTextAttribute * @see unum_setTextAttribute -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 unum_setDoubleAttribute( UNumberFormat* fmt, @@ -484,7 +484,7 @@ typedef enum UNumberFormatTextAttribute { * @see unum_setTextAttribute * @see unum_getAttribute * @see unum_setAttribute -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 unum_getTextAttribute( const UNumberFormat* fmt, @@ -505,7 +505,7 @@ unum_getTextAttribute( const UNumberFormat* fmt, * @see unum_getTextAttribute * @see unum_getAttribute * @see unum_setAttribute -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 unum_setTextAttribute( UNumberFormat* fmt, @@ -523,7 +523,7 @@ unum_setTextAttribute( UNumberFormat* fmt, * @param resultLength The maximum size of result. * @param status A pointer to an UErrorCode to receive any errors * @return The total buffer size needed; if greater than resultLength, the output was truncated. -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 unum_toPattern( const UNumberFormat* fmt, @@ -537,7 +537,7 @@ unum_toPattern( const UNumberFormat* fmt, /** * Constants for specifying a number format symbol. - * @stable + * @stable ICU 2.0 */ typedef enum UNumberFormatSymbol { /** The decimal separator */ @@ -588,7 +588,7 @@ typedef enum UNumberFormatSymbol { * @return The length of the symbol; the buffer is not modified if * length>=size * @see unum_setSymbol -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 unum_getSymbol(UNumberFormat *fmt, @@ -607,7 +607,7 @@ unum_getSymbol(UNumberFormat *fmt, * @param length The length of the string, or -1 for a zero-terminated string * @param status A pointer to an UErrorCode to receive any errors. * @see unum_getSymbol -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 unum_setSymbol(UNumberFormat *fmt, diff --git a/icu4c/source/i18n/unicode/usearch.h b/icu4c/source/i18n/unicode/usearch.h index b43ad783e3..998cc609c4 100644 --- a/icu4c/source/i18n/unicode/usearch.h +++ b/icu4c/source/i18n/unicode/usearch.h @@ -186,7 +186,7 @@ typedef enum { * patternlength or textlength is 0 then an * U_ILLEGAL_ARGUMENT_ERROR is returned. * @return search iterator data structure, or NULL if there is an error. -* @stable +* @stable ICU 2.0 */ U_CAPI UStringSearch * U_EXPORT2 usearch_open(const UChar *pattern, int32_t patternlength, @@ -216,7 +216,7 @@ U_CAPI UStringSearch * U_EXPORT2 usearch_open(const UChar *pattern, * or if patternlength or textlength is 0 then an * U_ILLEGAL_ARGUMENT_ERROR is returned. * @return search iterator data structure, or NULL if there is an error. -* @stable +* @stable ICU 2.0 */ U_CAPI UStringSearch * U_EXPORT2 usearch_openFromCollator( const UChar *pattern, @@ -231,7 +231,7 @@ U_CAPI UStringSearch * U_EXPORT2 usearch_openFromCollator( * Destroying and cleaning up the search iterator data struct. * If a collator is created in usearch_open, it will be destroyed here. * @param searchiter data struct to clean up -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 usearch_close(UStringSearch *strsrch); @@ -250,7 +250,7 @@ U_CAPI void U_EXPORT2 usearch_close(UStringSearch *strsrch); * than or greater than the text range for searching, * an U_INDEX_OUTOFBOUNDS_ERROR will be returned * @param status error status if any. -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 usearch_setOffset(UStringSearch *strsrch, int32_t position, @@ -262,7 +262,7 @@ U_CAPI void U_EXPORT2 usearch_setOffset(UStringSearch *strsrch, * for a backwards search), USEARCH_DONE is returned. * @param strsrch search iterator data struct * @see #USEARCH_DONE -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 usearch_getOffset(const UStringSearch *strsrch); @@ -275,7 +275,7 @@ U_CAPI int32_t U_EXPORT2 usearch_getOffset(const UStringSearch *strsrch); * @param value text attribute value * @param status for errors if it occurs * @see #usearch_getAttribute -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 usearch_setAttribute(UStringSearch *strsrch, USearchAttribute attribute, @@ -288,7 +288,7 @@ U_CAPI void U_EXPORT2 usearch_setAttribute(UStringSearch *strsrch, * @param attribute text attribute to be retrieve * @return text attribute value * @see #usearch_setAttribute -* @stable +* @stable ICU 2.0 */ U_CAPI USearchAttributeValue U_EXPORT2 usearch_getAttribute( const UStringSearch *strsrch, @@ -311,7 +311,7 @@ U_CAPI USearchAttributeValue U_EXPORT2 usearch_getAttribute( * @see #usearch_previous * @see #usearch_last * @see #USEARCH_DONE -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 usearch_getMatchedStart( const UStringSearch *strsrch); @@ -331,7 +331,7 @@ U_CAPI int32_t U_EXPORT2 usearch_getMatchedStart( * @see #usearch_previous * @see #usearch_last * @see #USEARCH_DONE -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 usearch_getMatchedLength( const UStringSearch *strsrch); @@ -359,7 +359,7 @@ U_CAPI int32_t U_EXPORT2 usearch_getMatchedLength( * @see #usearch_previous * @see #usearch_last * @see #USEARCH_DONE -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 usearch_getMatchedText(const UStringSearch *strsrch, UChar *result, @@ -381,7 +381,7 @@ U_CAPI int32_t U_EXPORT2 usearch_getMatchedText(const UStringSearch *strsrch, * attempted. * @param status for errors if it occurs * @see #usearch_getBreakIterator -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 usearch_setBreakIterator(UStringSearch *strsrch, UBreakIterator *breakiter, @@ -396,7 +396,7 @@ U_CAPI void U_EXPORT2 usearch_setBreakIterator(UStringSearch *strsrch, * @param strsrch search iterator data struct * @return break iterator used * @see #usearch_setBreakIterator -* @stable +* @stable ICU 2.0 */ U_CAPI const UBreakIterator * U_EXPORT2 usearch_getBreakIterator( const UStringSearch *strsrch); @@ -414,7 +414,7 @@ U_CAPI const UBreakIterator * U_EXPORT2 usearch_getBreakIterator( * then an U_ILLEGAL_ARGUMENT_ERROR is returned with no change * done to strsrch. * @see #usearch_getText -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 usearch_setText( UStringSearch *strsrch, const UChar *text, @@ -427,7 +427,7 @@ U_CAPI void U_EXPORT2 usearch_setText( UStringSearch *strsrch, * @param length returned string text length * @return string text * @see #usearch_setText -* @stable +* @stable ICU 2.0 */ U_CAPI const UChar * U_EXPORT2 usearch_getText(const UStringSearch *strsrch, int32_t *length); @@ -440,7 +440,7 @@ U_CAPI const UChar * U_EXPORT2 usearch_getText(const UStringSearch *strsrch, * usearch_close will delete the collator if this search owns it. * @param strsrch search iterator data struct * @return collator -* @stable +* @stable ICU 2.0 */ U_CAPI UCollator * U_EXPORT2 usearch_getCollator( const UStringSearch *strsrch); @@ -453,7 +453,7 @@ U_CAPI UCollator * U_EXPORT2 usearch_getCollator( * @param strsrch search iterator data struct * @param collator to be used * @param status for errors if it occurs -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 usearch_setCollator( UStringSearch *strsrch, const UCollator *collator, @@ -469,7 +469,7 @@ U_CAPI void U_EXPORT2 usearch_setCollator( UStringSearch *strsrch, * @param status for errors if it occurs. If text is NULL, or textlength is 0 * then an U_ILLEGAL_ARGUMENT_ERROR is returned with no change * done to strsrch. -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 usearch_setPattern( UStringSearch *strsrch, const UChar *pattern, @@ -482,7 +482,7 @@ U_CAPI void U_EXPORT2 usearch_setPattern( UStringSearch *strsrch, * @param length return length of the pattern, -1 indicates that the pattern * is null-terminated * @return pattern string -* @stable +* @stable ICU 2.0 */ U_CAPI const UChar * U_EXPORT2 usearch_getPattern( const UStringSearch *strsrch, @@ -503,7 +503,7 @@ U_CAPI const UChar * U_EXPORT2 usearch_getPattern( * USEARCH_DONE if there are no matches. * @see #usearch_getOffset * @see #USEARCH_DONE -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 usearch_first(UStringSearch *strsrch, UErrorCode *status); @@ -527,7 +527,7 @@ U_CAPI int32_t U_EXPORT2 usearch_first(UStringSearch *strsrch, * or USEARCH_DONE if there are no matches. * @see #usearch_getOffset * @see #USEARCH_DONE -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 usearch_following(UStringSearch *strsrch, int32_t position, @@ -546,7 +546,7 @@ U_CAPI int32_t U_EXPORT2 usearch_following(UStringSearch *strsrch, * are no matches. * @see #usearch_getOffset * @see #USEARCH_DONE -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 usearch_last(UStringSearch *strsrch, UErrorCode *status); @@ -569,7 +569,7 @@ U_CAPI int32_t U_EXPORT2 usearch_last(UStringSearch *strsrch, * or USEARCH_DONE if there are no matches. * @see #usearch_getOffset * @see #USEARCH_DONE -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 usearch_preceding(UStringSearch *strsrch, int32_t position, @@ -590,7 +590,7 @@ U_CAPI int32_t U_EXPORT2 usearch_preceding(UStringSearch *strsrch, * @see #usearch_first * @see #usearch_getOffset * @see #USEARCH_DONE -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 usearch_next(UStringSearch *strsrch, UErrorCode *status); @@ -610,7 +610,7 @@ U_CAPI int32_t U_EXPORT2 usearch_next(UStringSearch *strsrch, * @see #usearch_last * @see #usearch_getOffset * @see #USEARCH_DONE -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 usearch_previous(UStringSearch *strsrch, UErrorCode *status); @@ -623,7 +623,7 @@ U_CAPI int32_t U_EXPORT2 usearch_previous(UStringSearch *strsrch, * at the end of the text string. * @param strsrch search iterator data struct * @see #usearch_first -* @stable +* @stable ICU 2.0 */ U_CAPI void U_EXPORT2 usearch_reset(UStringSearch *strsrch); diff --git a/icu4c/source/i18n/unicode/utrans.h b/icu4c/source/i18n/unicode/utrans.h index 3fe9a7ed78..adec5497d9 100644 --- a/icu4c/source/i18n/unicode/utrans.h +++ b/icu4c/source/i18n/unicode/utrans.h @@ -48,7 +48,7 @@ * and close with utrans_close() when done. Equivalent to the C++ class * Transliterator and its subclasses. * @see Transliterator - * @stable + * @stable ICU 2.0 */ typedef void* UTransliterator; @@ -58,7 +58,7 @@ typedef void* UTransliterator; * Specified when a transliterator is opened. An "A-B" transliterator * transliterates A to B when operating in the forward direction, and * B to A when operating in the reverse direction. - * @stable + * @stable ICU 2.0 */ typedef enum UTransDirection { @@ -100,7 +100,7 @@ typedef enum UTransDirection { * of a surrogate pair. If any index does split a surrogate pair, * results are unspecified. * - * @stable + * @stable ICU 2.0 */ typedef struct UTransPosition { @@ -165,7 +165,7 @@ typedef struct UTransPosition { * @param status a pointer to the UErrorCode * @return a transliterator pointer that may be passed to other * utrans_xxx() functions, or NULL if the open call fails. - * @stable + * @stable ICU 2.0 */ U_CAPI UTransliterator* U_EXPORT2 utrans_open(const char* id, @@ -188,7 +188,7 @@ utrans_open(const char* id, * @param status a pointer to the UErrorCode * @return a pointer to a newly-opened transliterator that is the * inverse of trans, or NULL if the open call fails. - * @stable + * @stable ICU 2.0 */ U_CAPI UTransliterator* U_EXPORT2 utrans_openInverse(const UTransliterator* trans, @@ -202,7 +202,7 @@ utrans_openInverse(const UTransliterator* trans, * @param status a pointer to the UErrorCode * @return a transliterator pointer that may be passed to other * utrans_xxx() functions, or NULL if the clone call fails. - * @stable + * @stable ICU 2.0 */ U_CAPI UTransliterator* U_EXPORT2 utrans_clone(const UTransliterator* trans, @@ -212,7 +212,7 @@ utrans_clone(const UTransliterator* trans, * Close a transliterator. Any non-NULL pointer returned by * utrans_openXxx() or utrans_clone() should eventually be closed. * @param trans the transliterator to be closed. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 utrans_close(UTransliterator* trans); @@ -229,7 +229,7 @@ utrans_close(UTransliterator* trans); * NULL. * @return the actual length of the ID, not including * zero-termination. This may be greater than bufCapacity. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 utrans_getID(const UTransliterator* trans, @@ -248,7 +248,7 @@ utrans_getID(const UTransliterator* trans, * @param adoptedTrans a transliterator, typically the result of * utrans_openRules(), to be registered with the system. * @param status a pointer to the UErrorCode - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 utrans_register(UTransliterator* adoptedTrans, @@ -260,7 +260,7 @@ utrans_register(UTransliterator* adoptedTrans, * utrans_open(). If the id is invalid then nothing is done. * * @param id a zero-terminated ID - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 utrans_unregister(const char* id); @@ -281,7 +281,7 @@ utrans_unregister(const char* id); * filterPattern is zero-terminated * @param status a pointer to the UErrorCode * @see UnicodeSet - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 utrans_setFilter(UTransliterator* trans, @@ -292,7 +292,7 @@ utrans_setFilter(UTransliterator* trans, /** * Return the number of system transliterators. * @return the number of system transliterators. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 utrans_countAvailableIDs(void); @@ -312,7 +312,7 @@ utrans_countAvailableIDs(void); * NULL. * @return the actual length of the index-th ID, not including * zero-termination. This may be greater than bufCapacity. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 utrans_getAvailableID(int32_t index, @@ -344,7 +344,7 @@ utrans_getAvailableID(int32_t index, * new-limit), where new-limit * is the return value. * @param status a pointer to the UErrorCode - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 utrans_trans(const UTransliterator* trans, @@ -395,7 +395,7 @@ utrans_trans(const UTransliterator* trans, * @param pos a struct containing the start and limit indices of the * text to be read and the text to be transliterated * @param status a pointer to the UErrorCode - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 utrans_transIncremental(const UTransliterator* trans, @@ -433,7 +433,7 @@ utrans_transIncremental(const UTransliterator* trans, * new-limit), where new-limit * is the return value. * @param status a pointer to the UErrorCode - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 utrans_transUChars(const UTransliterator* trans, @@ -468,7 +468,7 @@ utrans_transUChars(const UTransliterator* trans, * text to be read and the text to be transliterated * @param status a pointer to the UErrorCode * @see utrans_transIncremental - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 utrans_transIncrementalUChars(const UTransliterator* trans,