ICU-2087 change @stable to @stable ICU 2.0

X-SVN-Rev: 10483
This commit is contained in:
Markus Scherer 2002-12-04 23:46:16 +00:00
parent 64e714a1ef
commit 2af8b25b5a
32 changed files with 788 additions and 788 deletions

View File

@ -143,7 +143,7 @@ U_NAMESPACE_BEGIN
* For example, subtracting 5 days from the date <code>September 12, 1996</code>
* results in <code>September 7, 1996</code>.
*
* @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 <code>when</code>, in terms of
* <code>field</code>.
* @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:
* <P>
* 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];

View File

@ -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:
* &lt;= X &lt; 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()) ...
* </pre>
* @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,

View File

@ -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);

View File

@ -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:
* </pre>
* @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<br>
* 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<br>
* 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);

View File

@ -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&);

View File

@ -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);

View File

@ -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()) ...
* </pre>
* @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(); }

View File

@ -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);

View File

@ -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; }

View File

@ -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);

View File

@ -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

View File

@ -134,14 +134,14 @@ U_NAMESPACE_BEGIN
* delete calendar; // also deletes pdt
* \endcode
* </pre>
* @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);

View File

@ -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()) ...
* </pre>
* @return The class ID for all objects of this class.
* @stable
* @stable ICU 2.0
*/
static UClassID getStaticClassID(void) { return (UClassID)&fgClassID; }

View File

@ -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()) ...
* </pre>
* @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&);

View File

@ -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;

View File

@ -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
* <tt>USEARCH_DONE</tt> if there are no matches.
* @see #getOffset
* @stable
* @stable ICU 2.0
*/
int32_t first(UErrorCode &status);
@ -314,7 +314,7 @@ public:
* <tt>position</tt>, or <tt>USEARCH_DONE</tt> 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 <tt>USEARCH_DONE</tt> if
* there are no matches.
* @see #getOffset
* @stable
* @stable ICU 2.0
*/
int32_t last(UErrorCode &status);
@ -348,7 +348,7 @@ public:
* <tt>position</tt>, or <tt>USEARCH_DONE</tt> 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 <tt>USEARCH_DONE</tt> 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 <tt>USEARCH_DONE</tt> 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();

View File

@ -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()) ...
* </pre>
* @return The class ID for all objects of this class.
* @stable
* @stable ICU 2.0
*/
static UClassID getStaticClassID(void) { return (UClassID)&fgClassID; }

View File

@ -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()) ...
* </pre>
* @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(); }

View File

@ -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 &lt; 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:
* </pre>
* @return the hash value based on the string's collation order.
* @see UnicodeString#hashCode
* @stable
* @stable ICU 2.0
*/
int32_t hashCode(void) const;

View File

@ -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:
* <tt>NULL</tt> 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:
* <tt>NULL</tt> 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:
* <tt>NULL</tt> 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;

View File

@ -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()) ...
* </pre>
* @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<br>
* 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<br>
* 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);

View File

@ -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:
* <code>GMT[+-]hh:mm</code>.
* @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 <code>LONG</code> or <code>SHORT</code>
* @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 <code>TimeZone</code> 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()) ...
* </pre>
* @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:
* </pre>
* @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);

View File

@ -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 <code>[start, </code><em>new-limit</em><code>)</code>, where
* <em>new-limit</em> 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 <code>index</code>
* is invalid
* @see UTransPosition
* @stable
* @stable ICU 2.0
*/
virtual void transliterate(Replaceable& text, UTransPosition& index,
const UnicodeString& insertion,
@ -460,7 +460,7 @@ public:
* <code>index.limit</code>.
* @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 <tt>NULL</tt>
* 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 <code>null</code> 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 <code>Transliterator</code> 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:
* <code>ID</code>, or <code>null</code> 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()) ...
* </pre>
* @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(); };

View File

@ -134,7 +134,7 @@
* For example, subtracting 5 days from the date <code>September 12, 1996</code>
* results in <code>September 7, 1996</code>.
*
* @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,

View File

@ -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);

View File

@ -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,

View File

@ -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,

View File

@ -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,

View File

@ -145,7 +145,7 @@ public:
/**
* Assignment operator.
* @stable
* @stable ICU 2.0
*/
UnicodeToHexTransliterator& operator=(const UnicodeToHexTransliterator&);

View File

@ -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
* <code>length&gt;=size</code>
* @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,

View File

@ -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 <tt>usearch_open</tt>, 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), <tt>USEARCH_DONE</tt> 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,
* <tt>usearch_close</tt> 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(
* <tt>USEARCH_DONE</tt> 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 <tt>USEARCH_DONE</tt> 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 <tt>USEARCH_DONE</tt> 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);

View File

@ -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,
* </code><em>new-limit</em><code>)</code>, where <em>new-limit</em>
* 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,
* </code><em>new-limit</em><code>)</code>, where <em>new-limit</em>
* 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,