From 64e714a1ef4781a04a48ed74c17edcd0c6deca10 Mon Sep 17 00:00:00 2001 From: Markus Scherer Date: Wed, 4 Dec 2002 23:39:56 +0000 Subject: [PATCH] ICU-2087 change @stable to @stable ICU 2.0 X-SVN-Rev: 10482 --- icu4c/source/common/unicode/brkiter.h | 54 ++--- icu4c/source/common/unicode/chariter.h | 74 +++--- icu4c/source/common/unicode/convert.h | 4 +- icu4c/source/common/unicode/dbbi.h | 20 +- icu4c/source/common/unicode/locid.h | 60 ++--- icu4c/source/common/unicode/normlzr.h | 66 +++--- icu4c/source/common/unicode/parseerr.h | 4 +- icu4c/source/common/unicode/parsepos.h | 22 +- icu4c/source/common/unicode/putil.h | 18 +- icu4c/source/common/unicode/rbbi.h | 46 ++-- icu4c/source/common/unicode/rep.h | 8 +- icu4c/source/common/unicode/resbund.h | 58 ++--- icu4c/source/common/unicode/schriter.h | 28 +-- icu4c/source/common/unicode/ubidi.h | 74 +++--- icu4c/source/common/unicode/ubrk.h | 28 +-- icu4c/source/common/unicode/uchar.h | 84 +++---- icu4c/source/common/unicode/uchriter.h | 68 +++--- icu4c/source/common/unicode/uclean.h | 2 +- icu4c/source/common/unicode/ucnv.h | 108 ++++----- icu4c/source/common/unicode/ucnv_cb.h | 10 +- icu4c/source/common/unicode/ucnv_err.h | 26 +-- icu4c/source/common/unicode/udata.h | 20 +- icu4c/source/common/unicode/uloc.h | 46 ++-- icu4c/source/common/unicode/umisc.h | 2 +- icu4c/source/common/unicode/unifilt.h | 6 +- icu4c/source/common/unicode/unifunct.h | 2 +- icu4c/source/common/unicode/uniset.h | 60 ++--- icu4c/source/common/unicode/unistr.h | 312 ++++++++++++------------- icu4c/source/common/unicode/unorm.h | 6 +- icu4c/source/common/unicode/urep.h | 14 +- icu4c/source/common/unicode/ures.h | 62 ++--- icu4c/source/common/unicode/ushape.h | 22 +- icu4c/source/common/unicode/ustring.h | 88 +++---- icu4c/source/common/unicode/utf.h | 8 +- icu4c/source/common/unicode/utypes.h | 8 +- icu4c/source/common/unicode/uversion.h | 2 +- 36 files changed, 760 insertions(+), 760 deletions(-) diff --git a/icu4c/source/common/unicode/brkiter.h b/icu4c/source/common/unicode/brkiter.h index 08591b0f8cf..5db7cfcc288 100644 --- a/icu4c/source/common/unicode/brkiter.h +++ b/icu4c/source/common/unicode/brkiter.h @@ -200,7 +200,7 @@ class U_COMMON_API BreakIterator : public UObject { public: /** * destructor - * @stable + * @stable ICU 2.0 */ virtual ~BreakIterator(); @@ -215,7 +215,7 @@ public: * BreakIterator, as the argument. Text is considered the same if * it contains the same characters, it need not be the same * object, and styles are not considered. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const BreakIterator&) const = 0; @@ -223,21 +223,21 @@ public: * Returns the complement of the result of operator== * @param ths The BreakIterator to be compared for inequality * @return the complement of the result of operator== - * @stable + * @stable ICU 2.0 */ UBool operator!=(const BreakIterator& rhs) const { return !operator==(rhs); } /** * Return a polymorphic copy of this object. This is an abstract * method which subclasses implement. - * @stable + * @stable ICU 2.0 */ virtual BreakIterator* clone(void) const = 0; /** * Return a polymorphic class ID for this object. Different subclasses * will return distinct unequal values. - * @stable + * @stable ICU 2.0 */ virtual UClassID getDynamicClassID(void) const = 0; @@ -245,7 +245,7 @@ public: * Return a CharacterIterator over the text being analyzed. * Changing the state of the returned iterator can have undefined consequences * on the operation of the break iterator. If you need to change it, clone it first. - * @stable + * @stable ICU 2.0 */ virtual const CharacterIterator& getText(void) const = 0; @@ -253,7 +253,7 @@ public: * Change the text over which this operates. The text boundary is * reset to the start. * @param text The UnicodeString used to change the text. - * @stable + * @stable ICU 2.0 */ virtual void setText(const UnicodeString &text) = 0; @@ -261,26 +261,26 @@ public: * Change the text over which this operates. The text boundary is * reset to the start. * @param it The CharacterIterator used to change the text. - * @stable + * @stable ICU 2.0 */ virtual void adoptText(CharacterIterator* it) = 0; /** * DONE is returned by previous() and next() after all valid * boundaries have been returned. - * @stable + * @stable ICU 2.0 */ static const int32_t DONE; /** * Return the index of the first character in the text being scanned. - * @stable + * @stable ICU 2.0 */ virtual int32_t first(void) = 0; /** * Return the index immediately BEYOND the last character in the text being scanned. - * @stable + * @stable ICU 2.0 */ virtual int32_t last(void) = 0; @@ -288,7 +288,7 @@ public: * Return the boundary preceding the current boundary. * @return The character index of the previous text boundary or DONE if all * boundaries have been returned. - * @stable + * @stable ICU 2.0 */ virtual int32_t previous(void) = 0; @@ -296,14 +296,14 @@ public: * Return the boundary following the current boundary. * @return The character index of the next text boundary or DONE if all * boundaries have been returned. - * @stable + * @stable ICU 2.0 */ virtual int32_t next(void) = 0; /** * Return character index of the current interator position within the text. * @return The boundary most recently returned. - * @stable + * @stable ICU 2.0 */ virtual int32_t current(void) const = 0; @@ -313,7 +313,7 @@ public: * the value BreakIterator.DONE * @param offset the offset to begin scanning. * @return The first boundary after the specified offset. - * @stable + * @stable ICU 2.0 */ virtual int32_t following(int32_t offset) = 0; @@ -323,7 +323,7 @@ public: * the value BreakIterator.DONE * @param offset the offset to begin scanning. * @return The first boundary before the specified offset. - * @stable + * @stable ICU 2.0 */ virtual int32_t preceding(int32_t offset) = 0; @@ -333,7 +333,7 @@ public: * to the first boundary position at or following the specified offset. * @param offset the offset to check. * @return True if "offset" is a boundary position. - * @stable + * @stable ICU 2.0 */ virtual UBool isBoundary(int32_t offset) = 0; @@ -344,7 +344,7 @@ public: * and positive values move to later boundaries. * @return The index of the nth boundary from the current position, or * DONE if there are fewer than |n| boundaries in the specfied direction. - * @stable + * @stable ICU 2.0 */ virtual int32_t next(int32_t n) = 0; @@ -365,7 +365,7 @@ public: * used; neither the requested locale nor any of its fall back locales * could be found. * The caller owns the returned object and is responsible for deleting it. - * @stable + * @stable ICU 2.0 */ static BreakIterator* createWordInstance(const Locale& where, UErrorCode& status); @@ -389,7 +389,7 @@ public: * used; neither the requested locale nor any of its fall back locales * could be found. * The caller owns the returned object and is responsible for deleting it. - * @stable + * @stable ICU 2.0 */ static BreakIterator* createLineInstance(const Locale& where, UErrorCode& status); @@ -411,7 +411,7 @@ public: * used; neither the requested locale nor any of its fall back locales * could be found. * The caller owns the returned object and is responsible for deleting it. - * @stable + * @stable ICU 2.0 */ static BreakIterator* createCharacterInstance(const Locale& where, UErrorCode& status); @@ -432,7 +432,7 @@ public: * used; neither the requested locale nor any of its fall back locales * could be found. * The caller owns the returned object and is responsible for deleting it. - * @stable + * @stable ICU 2.0 */ static BreakIterator* createSentenceInstance(const Locale& where, UErrorCode& status); @@ -464,7 +464,7 @@ public: * call.

* @param count the output parameter of number of elements in the locale list * @return available locales - * @stable + * @stable ICU 2.0 */ static const Locale* getAvailableLocales(int32_t& count); @@ -475,7 +475,7 @@ public: * @param name the fill-in parameter of the return value * Uses best match. * @return user-displayable name - * @stable + * @stable ICU 2.0 */ static UnicodeString& getDisplayName(const Locale& objectLocale, const Locale& displayLocale, @@ -487,7 +487,7 @@ public: * @param objectLocale must be from getMatchingLocales * @param name the fill-in parameter of the return value * @return user-displayable name - * @stable + * @stable ICU 2.0 */ static UnicodeString& getDisplayName(const Locale& objectLocale, UnicodeString& name); @@ -507,7 +507,7 @@ public: * necessary. * @return pointer to the new clone * - * @stable + * @stable ICU 2.0 */ virtual BreakIterator * createBufferClone(void *stackBuffer, int32_t &BufferSize, @@ -517,7 +517,7 @@ public: * Determine whether the BreakIterator was created in user memory by * createBufferClone(), and thus should not be deleted. Such objects * must be closed by an explicit call to the destructor (not delete). - * @stable + * @stable ICU 2.0 */ inline UBool isBufferClone(void); diff --git a/icu4c/source/common/unicode/chariter.h b/icu4c/source/common/unicode/chariter.h index a2ad41a6127..284e05068a9 100644 --- a/icu4c/source/common/unicode/chariter.h +++ b/icu4c/source/common/unicode/chariter.h @@ -80,20 +80,20 @@ U_NAMESPACE_BEGIN * \endcode *

* - * @stable + * @stable ICU 2.0 */ class U_COMMON_API ForwardCharacterIterator : public UObject { public: /** * Value returned by most of ForwardCharacterIterator's functions * when the iterator has reached the limits of its iteration. - * @stable + * @stable ICU 2.0 */ enum { DONE = 0xffff }; /** * Destructor. - * @stable + * @stable ICU 2.0 */ virtual ~ForwardCharacterIterator() {} @@ -103,7 +103,7 @@ public: * @param that The ForwardCharacterIterator to be compared for equality * @return true when both iterators refer to the same * character in the same character-storage object - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const ForwardCharacterIterator& that) const = 0; @@ -115,14 +115,14 @@ public: * @Returns true when the iterators refer to different * text-storage objects, or to different characters in the * same text-storage object - * @stable + * @stable ICU 2.0 */ inline UBool operator!=(const ForwardCharacterIterator& that) const; /** * Generates a hash code for this iterator. * @return the hash code. - * @stable + * @stable ICU 2.0 */ virtual int32_t hashCode(void) const = 0; @@ -131,7 +131,7 @@ public: * RTTI").

Despite the fact that this function is public, * DO NOT CONSIDER IT PART OF CHARACTERITERATOR'S API! * @Returns a UClassID for this ForwardCharacterIterator - * @stable + * @stable ICU 2.0 */ virtual UClassID getDynamicClassID(void) const = 0; @@ -141,7 +141,7 @@ public: * (toward endIndex()). If there are * no more code units to return, returns DONE. * @return the current code unit. - * @stable + * @stable ICU 2.0 */ virtual UChar nextPostInc(void) = 0; @@ -151,7 +151,7 @@ public: * (toward endIndex()). If there are * no more code points to return, returns DONE. * @return the current code point. - * @stable + * @stable ICU 2.0 */ virtual UChar32 next32PostInc(void) = 0; @@ -162,7 +162,7 @@ public: * iteration. * @returns FALSE if there are no more code units or code points * at or after the current position in the iteration range. - * @stable + * @stable ICU 2.0 */ virtual UBool hasNext() = 0; @@ -346,13 +346,13 @@ protected: * \endcode * * - * @stable + * @stable ICU 2.0 */ class U_COMMON_API CharacterIterator : public ForwardCharacterIterator { public: /** * Origin enumeration for the move() and move32() functions. - * @stable + * @stable ICU 2.0 */ enum EOrigin { kStart, kCurrent, kEnd }; @@ -362,7 +362,7 @@ public: * character in the same text-storage object as this one. The * caller is responsible for deleting the new clone. * @return a pointer to a new CharacterIterator - * @stable + * @stable ICU 2.0 */ virtual CharacterIterator* clone(void) const = 0; @@ -371,7 +371,7 @@ public: * iteration range, and returns that code unit. * This can be used to begin an iteration with next(). * @return the first code unit in its iteration range. - * @stable + * @stable ICU 2.0 */ virtual UChar first(void) = 0; @@ -381,7 +381,7 @@ public: * to the second code unit. This is an alternative to setToStart() * for forward iteration with nextPostInc(). * @return the first code unit in its iteration range. - * @stable + * @stable ICU 2.0 */ virtual UChar firstPostInc(void); @@ -392,7 +392,7 @@ public: * Note that an iteration with next32PostInc(), beginning with, * e.g., setToStart() or firstPostInc(), is more efficient. * @return the first code point in its iteration range. - * @stable + * @stable ICU 2.0 */ virtual UChar32 first32(void) = 0; @@ -402,7 +402,7 @@ public: * to the second code point. This is an alternative to setToStart() * for forward iteration with next32PostInc(). * @return the first code point in its iteration range. - * @stable + * @stable ICU 2.0 */ virtual UChar32 first32PostInc(void); @@ -411,7 +411,7 @@ public: * iteration range. This can be used to begin a forward * iteration with nextPostInc() or next32PostInc(). * @return the start position of the iteration range - * @stable + * @stable ICU 2.0 */ inline int32_t setToStart(); @@ -420,7 +420,7 @@ public: * iteration range, and returns that code unit. * This can be used to begin an iteration with previous(). * @return the last code unit. - * @stable + * @stable ICU 2.0 */ virtual UChar last(void) = 0; @@ -429,7 +429,7 @@ public: * iteration range, and returns that code unit. * This can be used to begin an iteration with previous32(). * @return the last code point. - * @stable + * @stable ICU 2.0 */ virtual UChar32 last32(void) = 0; @@ -438,7 +438,7 @@ public: * the last code unit or code point. This can be used to begin a backward * iteration with previous() or previous32(). * @return the end position of the iteration range - * @stable + * @stable ICU 2.0 */ inline int32_t setToEnd(); @@ -448,7 +448,7 @@ public: * returns that code unit. * @param position the "position"-th code unit in the text-storage object * @return the "position"-th code unit. - * @stable + * @stable ICU 2.0 */ virtual UChar setIndex(int32_t position) = 0; @@ -461,21 +461,21 @@ public: * (its first code unit). * @param position the "position"-th code unit in the text-storage object * @return the "position"-th code point. - * @stable + * @stable ICU 2.0 */ virtual UChar32 setIndex32(int32_t position) = 0; /** * Returns the code unit the iterator currently refers to. * @return the current code unit. - * @stable + * @stable ICU 2.0 */ virtual UChar current(void) const = 0; /** * Returns the code point the iterator currently refers to. * @return the current code point. - * @stable + * @stable ICU 2.0 */ virtual UChar32 current32(void) const = 0; @@ -484,7 +484,7 @@ public: * (toward endIndex()), and returns that code unit. If there are * no more code units to return, returns DONE. * @return the next code unit. - * @stable + * @stable ICU 2.0 */ virtual UChar next(void) = 0; @@ -496,7 +496,7 @@ public: * efficient than iteration with "post-increment" semantics * that is provided by next32PostInc(). * @return the next code point. - * @stable + * @stable ICU 2.0 */ virtual UChar32 next32(void) = 0; @@ -505,7 +505,7 @@ public: * (toward startIndex()), and returns that code unit. If there are * no more code units to return, returns DONE. * @return the previous code unit. - * @stable + * @stable ICU 2.0 */ virtual UChar previous(void) = 0; @@ -514,7 +514,7 @@ public: * (toward startIndex()), and returns that code point. If there are * no more code points to return, returns DONE. * @return the previous code point. - * @stable + * @stable ICU 2.0 */ virtual UChar32 previous32(void) = 0; @@ -525,7 +525,7 @@ public: * iteration. * @return FALSE if there are no more code units or code points * before the current position in the iteration range, return TRUE otherwise. - * @stable + * @stable ICU 2.0 */ virtual UBool hasPrevious() = 0; @@ -537,7 +537,7 @@ public: * necessarily 0. * @returns the numeric index in the underlying text-storage * object of the character returned by first(). - * @stable + * @stable ICU 2.0 */ inline int32_t startIndex(void) const; @@ -548,7 +548,7 @@ public: * @return the numeric index in the underlying text-storage * object of the position immediately BEYOND the character * returned by last(). - * @stable + * @stable ICU 2.0 */ inline int32_t endIndex(void) const; @@ -558,7 +558,7 @@ public: * (i.e., the character returned by current()). * @return the numberic index in the text-storage object of * the character the iterator currently refers to - * @stable + * @stable ICU 2.0 */ inline int32_t getIndex(void) const; @@ -566,7 +566,7 @@ public: * Returns the length of the entire text in the underlying * text-storage object. * @return the length of the entire text in the text-storage object - * @stable + * @stable ICU 2.0 */ inline int32_t getLength() const; @@ -579,7 +579,7 @@ public: * a negative delta means backward. * @origin Origin enumeration {kStart, kCurrent, kEnd} * @return the new position - * @stable + * @stable ICU 2.0 */ virtual int32_t move(int32_t delta, EOrigin origin) = 0; @@ -592,7 +592,7 @@ public: * a negative delta means backward. * @origin Origin enumeration {kStart, kCurrent, kEnd} * @return the new position - * @stable + * @stable ICU 2.0 */ virtual int32_t move32(int32_t delta, EOrigin origin) = 0; @@ -600,7 +600,7 @@ public: * Copies the text under iteration into the UnicodeString * referred to by "result". * @param result Receives a copy of the text under iteration. - * @stable + * @stable ICU 2.0 */ virtual void getText(UnicodeString& result) = 0; diff --git a/icu4c/source/common/unicode/convert.h b/icu4c/source/common/unicode/convert.h index 40c88c798ed..4cba593be22 100644 --- a/icu4c/source/common/unicode/convert.h +++ b/icu4c/source/common/unicode/convert.h @@ -392,7 +392,7 @@ UConverterPlatform getCodepagePlatform(UErrorCode& err) const; * @param that The UnicodeConverter to be compared for equality * @return true when both UnicodeConverters refer to the same * character in the same character-storage object - * @stable + * @stable ICU 2.0 */ UBool operator==(const UnicodeConverter& that) const; @@ -404,7 +404,7 @@ UConverterPlatform getCodepagePlatform(UErrorCode& err) const; * @Returns true when the iterators refer to different * text-storage objects, or to different characters in the * same text-storage object - * @stable + * @stable ICU 2.0 */ UBool operator!=(const UnicodeConverter& that) const; diff --git a/icu4c/source/common/unicode/dbbi.h b/icu4c/source/common/unicode/dbbi.h index 80776ac56ab..2d97bcfb079 100644 --- a/icu4c/source/common/unicode/dbbi.h +++ b/icu4c/source/common/unicode/dbbi.h @@ -111,7 +111,7 @@ public: /** * Destructor - * @stable + * @stable ICU 2.0 */ virtual ~DictionaryBasedBreakIterator(); @@ -119,7 +119,7 @@ public: * Default constructor. Creates an "empty" break iterator. * Such an iterator can subsequently be assigned to. * @return the newly created DictionaryBaseBreakIterator. - * @stable + * @stable ICU 2.0 */ DictionaryBasedBreakIterator(); @@ -127,7 +127,7 @@ public: * Copy constructor. * @param other The DictionaryBasedBreakIterator to be copied. * @return the newly created DictionaryBasedBreakIterator. - * @stable + * @stable ICU 2.0 */ DictionaryBasedBreakIterator(const DictionaryBasedBreakIterator &other); @@ -135,7 +135,7 @@ public: * Assignment operator. * @param that The object to be copied. * @return the newly set DictionaryBasedBreakIterator. - * @stable + * @stable ICU 2.0 */ DictionaryBasedBreakIterator& operator=(const DictionaryBasedBreakIterator& that); @@ -143,7 +143,7 @@ public: * Returns a newly-constructed RuleBasedBreakIterator with the same * behavior, and iterating over the same text, as this one. * @return Returns a newly-constructed RuleBasedBreakIterator. - * @stable + * @stable ICU 2.0 */ virtual BreakIterator* clone(void) const; @@ -153,7 +153,7 @@ public: /** * Advances the iterator backwards, to the last boundary preceding this one. * @return The position of the last boundary position preceding this one. - * @stable + * @stable ICU 2.0 */ virtual int32_t previous(void); @@ -162,7 +162,7 @@ public: * the specified position. * @offset The position from which to begin searching for a break position. * @return The position of the first break after the current position. - * @stable + * @stable ICU 2.0 */ virtual int32_t following(int32_t offset); @@ -171,7 +171,7 @@ public: * specified position. * @offset The position to begin searching for a break from. * @return The position of the last boundary before the starting position. - * @stable + * @stable ICU 2.0 */ virtual int32_t preceding(int32_t offset); @@ -184,7 +184,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; @@ -197,7 +197,7 @@ public: * Derived::getStaticClassID()) ... * * @return The class ID for all objects of this class. - * @stable + * @stable ICU 2.0 */ static UClassID getStaticClassID(void); diff --git a/icu4c/source/common/unicode/locid.h b/icu4c/source/common/unicode/locid.h index 98ed34a895f..71619140261 100644 --- a/icu4c/source/common/unicode/locid.h +++ b/icu4c/source/common/unicode/locid.h @@ -173,7 +173,7 @@ * * * - * @stable + * @stable ICU 2.0 */ U_NAMESPACE_BEGIN class U_COMMON_API Locale : public UObject { @@ -332,7 +332,7 @@ public: /** * Construct an empty locale. It's only used when a fill-in parameter is * needed. - * @stable + * @stable ICU 2.0 */ Locale(); @@ -349,7 +349,7 @@ public: * @param country Uppercase two-letter ISO-3166 code. (optional) * @param variant Uppercase vendor and browser specific code. See class * description. (optional) - * @stable + * @stable ICU 2.0 */ Locale( const char * language, const char * country = 0, @@ -359,14 +359,14 @@ public: * Initializes a Locale object from another Locale object. * * @param other The Locale object being copied in. - * @stable + * @stable ICU 2.0 */ Locale(const Locale& other); /** * Destructor - * @stable + * @stable ICU 2.0 */ ~Locale() ; @@ -375,7 +375,7 @@ public: * * @param other The Locale object being copied in. * @return *this - * @stable + * @stable ICU 2.0 */ Locale& operator=(const Locale& other); @@ -384,7 +384,7 @@ public: * * @param other The locale key object to be compared with this. * @return True if the two locale keys are the same, false otherwise. - * @stable + * @stable ICU 2.0 */ UBool operator==(const Locale& other) const; @@ -394,7 +394,7 @@ public: * @param other The locale key object to be compared with this. * @return True if the two locale keys are not the same, false * otherwise. - * @stable + * @stable ICU 2.0 */ UBool operator!=(const Locale& other) const; @@ -411,7 +411,7 @@ public: * Note that the initial setting will match the host system. * @retrun the default locale for this instance of the Java Virtual Machine * @system - * @stable + * @stable ICU 2.0 */ static const Locale& getDefault(void); @@ -422,7 +422,7 @@ public: * @param newLocale Locale to set to. * @param success The error code. * @system - * @stable + * @stable ICU 2.0 */ static void setDefault(const Locale& newLocale, UErrorCode& success); @@ -434,7 +434,7 @@ public: * @param name The name to create from. If name is null, * the default Locale is used. * @return new locale object - * @stable + * @stable ICU 2.0 * @see uloc_getName */ static Locale createFromName(const char *name); @@ -443,21 +443,21 @@ public: /** * Returns the locale's ISO-639 language code. * @return An alias to the code - * @stable + * @stable ICU 2.0 */ inline const char * getLanguage( ) const; /** * Returns the locale's ISO-3166 country code. * @return An alias to the code - * @stable + * @stable ICU 2.0 */ inline const char * getCountry( ) const; /** * Returns the locale's variant code. * @return An alias to the code - * @stable + * @stable ICU 2.0 */ inline const char * getVariant( ) const; @@ -467,7 +467,7 @@ public: * to two leading underbars will occur. Example: "en", "de_DE", "en_US_WIN", * "de__POSIX", "fr__MAC", "__MAC", "_MT", "_FR_EURO" * @return A pointer to "name". - * @stable + * @stable ICU 2.0 */ inline const char * getName() const; @@ -475,14 +475,14 @@ public: * returns the locale's three-letter language code, as specified * in ISO draft standard ISO-639-2.. * @return An alias to the code, or NULL - * @stable + * @stable ICU 2.0 */ const char * getISO3Language() const; /** * Fills in "name" with the locale's three-letter ISO-3166 country code. * @return An alias to the code, or NULL - * @stable + * @stable ICU 2.0 */ const char * getISO3Country() const; @@ -491,7 +491,7 @@ public: * This value is stored in the resource data for the locale as a one-to-four-digit * hexadecimal number. If the resource is missing, in the wrong format, or * there is no Windows LCID value that corresponds to this locale, returns 0. - * @stable + * @stable ICU 2.0 */ uint32_t getLCID(void) const; @@ -502,7 +502,7 @@ public: * dispLang to "French". * @param dispLang Receives the language's display name. * @return A reference to "dispLang". - * @stable + * @stable ICU 2.0 */ UnicodeString& getDisplayLanguage(UnicodeString& dispLang) const; @@ -517,7 +517,7 @@ public: * for inLocale would result in "Englisch". * @param dispLang Receives the language's display name. * @return A reference to "dispLang". - * @stable + * @stable ICU 2.0 */ UnicodeString& getDisplayLanguage( const Locale& inLocale, UnicodeString& dispLang) const; @@ -529,7 +529,7 @@ public: * dispCountry to "France". * @param dispCountry Receives the country's display name. * @return A reference to "dispCountry". - * @stable + * @stable ICU 2.0 */ UnicodeString& getDisplayCountry( UnicodeString& dispCountry) const; @@ -545,7 +545,7 @@ public: * "Vereinigte Staaten". * @param dispCountry Receives the country's display name. * @return A reference to "dispCountry". - * @stable + * @stable ICU 2.0 */ UnicodeString& getDisplayCountry( const Locale& inLocale, UnicodeString& dispCountry) const; @@ -555,7 +555,7 @@ public: * for user display in the default locale. * @param dispVar Receives the variant's name. * @return A reference to "dispVar". - * @stable + * @stable ICU 2.0 */ UnicodeString& getDisplayVariant( UnicodeString& dispVar) const; @@ -565,7 +565,7 @@ public: * @param inLocale Specifies the locale to be used to display the name. * @param dispVar Receives the variant's display name. * @return A reference to "dispVar". - * @stable + * @stable ICU 2.0 */ UnicodeString& getDisplayVariant( const Locale& inLocale, UnicodeString& dispVar) const; @@ -579,7 +579,7 @@ public: * would be "Spanish (Mexico,Traditional)". * @param name Receives the locale's display name. * @return A reference to "name". - * @stable + * @stable ICU 2.0 */ UnicodeString& getDisplayName( UnicodeString& name) const; @@ -593,14 +593,14 @@ public: * @param inLocale Specifies the locale to be used to display the name. * @param name Receives the locale's display name. * @return A reference to "name". - * @stable + * @stable ICU 2.0 */ UnicodeString& getDisplayName( const Locale& inLocale, UnicodeString& name) const; /** * Generates a hash code for the locale. - * @stable + * @stable ICU 2.0 */ int32_t hashCode(void) const; @@ -627,7 +627,7 @@ public: * @return A pointer to an array of Locale objects. This array is the list * of all locales with installed resource files. The called does NOT * get ownership of this list, and must NOT delete it. - * @stable + * @stable ICU 2.0 */ static const Locale* getAvailableLocales(int32_t& count); @@ -637,7 +637,7 @@ public: * owned by ICU-- do not delete them, and do not write through them. The array is * terminated with a null pointer. * @return a list of all available country codes - * @stable + * @stable ICU 2.0 */ static const char* const* getISOCountries(); @@ -647,7 +647,7 @@ public: * by ICU-- do not delete them, and do not write through them. The array is * terminated with a null pointer. * @return a list of all available language codes - * @stable + * @stable ICU 2.0 */ static const char* const* getISOLanguages(); diff --git a/icu4c/source/common/unicode/normlzr.h b/icu4c/source/common/unicode/normlzr.h index be93d46cc9e..17ba4c6bee4 100644 --- a/icu4c/source/common/unicode/normlzr.h +++ b/icu4c/source/common/unicode/normlzr.h @@ -107,14 +107,14 @@ U_NAMESPACE_BEGIN * later with setIndexOnly(). * * @author Laura Werner, Mark Davis, Markus Scherer - * @stable + * @stable ICU 2.0 */ class U_COMMON_API Normalizer : public UObject { public: /** * If DONE is returned from an iteration function that returns a code point, * then there are no more normalization results available. - * @stable + * @stable ICU 2.0 */ enum { DONE=0xffff @@ -130,7 +130,7 @@ public: * will start at the beginning of the string. * * @param mode The normalization mode. - * @stable + * @stable ICU 2.0 */ Normalizer(const UnicodeString& str, UNormalizationMode mode); @@ -143,7 +143,7 @@ public: * * @param length Length of the string, or -1 if NUL-terminated. * @param mode The normalization mode. - * @stable + * @stable ICU 2.0 */ Normalizer(const UChar* str, int32_t length, UNormalizationMode mode); @@ -155,20 +155,20 @@ public: * will start at the beginning of the string. * * @param mode The normalization mode. - * @stable + * @stable ICU 2.0 */ Normalizer(const CharacterIterator& iter, UNormalizationMode mode); /** * Copy constructor. * @param copy The object to be copied. - * @stable + * @stable ICU 2.0 */ Normalizer(const Normalizer& copy); /** * Destructor - * @stable + * @stable ICU 2.0 */ ~Normalizer(); @@ -192,7 +192,7 @@ public: * @param options the optional features to be enabled (0 for no options) * @param result The normalized string (on output). * @param status The error code. - * @stable + * @stable ICU 2.0 */ static void normalize(const UnicodeString& source, UNormalizationMode mode, int32_t options, @@ -218,7 +218,7 @@ public: * @param options the optional features to be enabled (0 for no options) * @param result The composed string (on output). * @param status The error code. - * @stable + * @stable ICU 2.0 */ static void compose(const UnicodeString& source, UBool compat, int32_t options, @@ -245,7 +245,7 @@ public: * @param options the optional features to be enabled (0 for no options) * @param result The decomposed string (on output). * @param status The error code. - * @stable + * @stable ICU 2.0 */ static void decompose(const UnicodeString& source, UBool compat, int32_t options, @@ -270,7 +270,7 @@ public: * @return UNORM_YES, UNORM_NO or UNORM_MAYBE * * @see isNormalized - * @stable + * @stable ICU 2.0 */ static inline UNormalizationCheckResult quickCheck(const UnicodeString &source, UNormalizationMode mode, UErrorCode &status); @@ -410,7 +410,7 @@ public: * The getIndex() is not changed. * * @return the current normalized code point - * @stable + * @stable ICU 2.0 */ UChar32 current(void); @@ -420,7 +420,7 @@ public: * (Post-increment semantics.) * * @return the first normalized code point - * @stable + * @stable ICU 2.0 */ UChar32 first(void); @@ -430,7 +430,7 @@ public: * (Pre-decrement semantics.) * * @return the last normalized code point - * @stable + * @stable ICU 2.0 */ UChar32 last(void); @@ -440,7 +440,7 @@ public: * If the end of the text has already been reached, {@link #DONE} is returned. * * @return the next normalized code point - * @stable + * @stable ICU 2.0 */ UChar32 next(void); @@ -450,7 +450,7 @@ public: * If the beginning of the text has already been reached, {@link #DONE} is returned. * * @return the previous normalized code point - * @stable + * @stable ICU 2.0 */ UChar32 previous(void); @@ -484,14 +484,14 @@ public: * specified here. * * @param index the desired index in the input text. - * @stable + * @stable ICU 2.0 */ void setIndexOnly(int32_t index); /** * Reset the index to the beginning of the text. * This is equivalent to setIndexOnly(startIndex)). - * @stable + * @stable ICU 2.0 */ void reset(void); @@ -507,7 +507,7 @@ public: * was returned from with previous(). * * @return the current index in the input text - * @stable + * @stable ICU 2.0 */ int32_t getIndex(void) const; @@ -517,7 +517,7 @@ public: * over which this Normalizer is iterating. * * @return the smallest index in the input text where the Normalizer operates - * @stable + * @stable ICU 2.0 */ int32_t startIndex(void) const; @@ -529,7 +529,7 @@ public: * before this index. * * @return the first index in the input text where the Normalizer does not operate - * @stable + * @stable ICU 2.0 */ int32_t endIndex(void) const; @@ -539,7 +539,7 @@ public: * * @param that a Normalizer object to compare this one to * @return comparison result - * @stable + * @stable ICU 2.0 */ UBool operator==(const Normalizer& that) const; @@ -549,7 +549,7 @@ public: * * @param that a Normalizer object to compare this one to * @return comparison result - * @stable + * @stable ICU 2.0 */ inline UBool operator!=(const Normalizer& that) const; @@ -557,7 +557,7 @@ public: * Returns a pointer to a new Normalizer that is a clone of this one. * The caller is responsible for deleting the new clone. * @return a pointer to a new Normalizer - * @stable + * @stable ICU 2.0 */ Normalizer* clone(void) const; @@ -565,7 +565,7 @@ public: * Generates a hash code for this iterator. * * @return the hash code - * @stable + * @stable ICU 2.0 */ int32_t hashCode(void) const; @@ -586,7 +586,7 @@ public: *

* @param newMode the new mode for this Normalizer. * @see #getUMode - * @stable + * @stable ICU 2.0 */ void setMode(UNormalizationMode newMode); @@ -598,7 +598,7 @@ public: * * @return the mode for this Normalizer * @see #setMode - * @stable + * @stable ICU 2.0 */ UNormalizationMode getUMode(void) const; @@ -616,7 +616,7 @@ public: * turn the option(s) on and FALSE to turn it/them off. * * @see #getOption - * @stable + * @stable ICU 2.0 */ void setOption(int32_t option, UBool value); @@ -629,7 +629,7 @@ public: * @param option the option(s) that are to be checked * @return TRUE if any of the option(s) are set * @see #setOption - * @stable + * @stable ICU 2.0 */ UBool getOption(int32_t option) const; @@ -639,7 +639,7 @@ public: * * @param newText a string that replaces the current input text * @param status a UErrorCode - * @stable + * @stable ICU 2.0 */ void setText(const UnicodeString& newText, UErrorCode &status); @@ -650,7 +650,7 @@ public: * * @param newText a CharacterIterator object that replaces the current input text * @param status a UErrorCode - * @stable + * @stable ICU 2.0 */ void setText(const CharacterIterator& newText, UErrorCode &status); @@ -662,7 +662,7 @@ public: * @param newText a string that replaces the current input text * @param length the length of the string, or -1 if NUL-terminated * @param status a UErrorCode - * @stable + * @stable ICU 2.0 */ void setText(const UChar* newText, int32_t length, @@ -671,7 +671,7 @@ public: * Copies the input text into the UnicodeString argument. * * @param result Receives a copy of the text under iteration. - * @stable + * @stable ICU 2.0 */ void getText(UnicodeString& result); diff --git a/icu4c/source/common/unicode/parseerr.h b/icu4c/source/common/unicode/parseerr.h index db931d58fa4..68c305a44c3 100644 --- a/icu4c/source/common/unicode/parseerr.h +++ b/icu4c/source/common/unicode/parseerr.h @@ -16,7 +16,7 @@ /** * The capacity of the context strings in UParseError. - * @stable + * @stable ICU 2.0 */ enum { U_PARSE_CONTEXT_LEN = 16 }; @@ -35,7 +35,7 @@ enum { U_PARSE_CONTEXT_LEN = 16 }; *

Examples of engines which use UParseError (or may use it in the * future) are RuleBasedTransliterator and RuleBasedBreakIterator. * - * @stable + * @stable ICU 2.0 */ typedef struct UParseError { diff --git a/icu4c/source/common/unicode/parsepos.h b/icu4c/source/common/unicode/parsepos.h index 2d97800d11c..36c6ab89698 100644 --- a/icu4c/source/common/unicode/parsepos.h +++ b/icu4c/source/common/unicode/parsepos.h @@ -43,7 +43,7 @@ class U_COMMON_API ParsePosition : public UObject { public: /** * Default constructor, the index starts with 0 as default. - * @stable + * @stable ICU 2.0 */ ParsePosition() : UObject() @@ -52,7 +52,7 @@ public: /** * Create a new ParsePosition with the given initial index. * @param newIndex the new text offset. - * @stable + * @stable ICU 2.0 */ ParsePosition(int32_t newIndex) : UObject() @@ -61,7 +61,7 @@ public: /** * Copy constructor * @param copy the object to be copied from. - * @stable + * @stable ICU 2.0 */ ParsePosition(const ParsePosition& copy) : UObject(copy) @@ -69,27 +69,27 @@ public: /** * Destructor - * @stable + * @stable ICU 2.0 */ ~ParsePosition() {} /** * Assignment operator - * @stable + * @stable ICU 2.0 */ ParsePosition& operator=(const ParsePosition& copy); /** * Equality operator. * @return TRUE if the two parse positions are equal, FALSE otherwise. - * @stable + * @stable ICU 2.0 */ UBool operator==(const ParsePosition& that) const; /** * Equality operator. * @return TRUE if the two parse positions are not equal, FALSE otherwise. - * @stable + * @stable ICU 2.0 */ UBool operator!=(const ParsePosition& that) const; @@ -98,14 +98,14 @@ public: * is the index of the character at which parsing will begin; on output, it * is the index of the character following the last character parsed. * @return the current index. - * @stable + * @stable ICU 2.0 */ int32_t getIndex(void) const; /** * Set the current parse position. * @param index the new index. - * @stable + * @stable ICU 2.0 */ void setIndex(int32_t index); @@ -114,14 +114,14 @@ public: * should set this before returning an error code from their * parseObject method. The default value is -1 if this is not * set. - * @stable + * @stable ICU 2.0 */ void setErrorIndex(int32_t ei); /** * Retrieve the index at which an error occurred, or -1 if the * error index has not been set. - * @stable + * @stable ICU 2.0 */ int32_t getErrorIndex(void) const; diff --git a/icu4c/source/common/unicode/putil.h b/icu4c/source/common/unicode/putil.h index 61083890b40..5db5f029933 100644 --- a/icu4c/source/common/unicode/putil.h +++ b/icu4c/source/common/unicode/putil.h @@ -134,7 +134,7 @@ U_CAPI int32_t U_EXPORT2 uprv_digitsAfterDecimal(double x); * information specified by the operating system. Under Windows NT * and Windows 95, this information is specified in the Control Panel’s * Date/Time application. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 uprv_tzset(void); @@ -157,7 +157,7 @@ U_CAPI char* U_EXPORT2 uprv_tzname(int n); /** * Get UTC (GMT) time measured in seconds since 0:00 on 1/1/70. * @return the UTC time measured in seconds - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 uprv_getUTCtime(void); @@ -180,7 +180,7 @@ U_CAPI int32_t U_EXPORT2 uprv_getUTCtime(void); * @return the data directory, or an empty string ("") if no data directory has * been specified. * - * @stable + * @stable ICU 2.0 */ U_CAPI const char* U_EXPORT2 u_getDataDirectory(void); @@ -195,7 +195,7 @@ U_CAPI const char* U_EXPORT2 u_getDataDirectory(void); * This function should be called at most once in a process, before the * first ICU operation that will require the loading of an ICU data file. * @param disrectory The directory to be set. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 u_setDataDirectory(const char *directory); @@ -204,7 +204,7 @@ U_CAPI void U_EXPORT2 u_setDataDirectory(const char *directory); * This function can call setlocale() on Unix platforms. Please read the * platform documentation on setlocale() before calling this function. * @return the default codepage for this platform - * @stable + * @stable ICU 2.0 */ U_CAPI const char* U_EXPORT2 uprv_getDefaultCodepage(void); @@ -214,7 +214,7 @@ U_CAPI const char* U_EXPORT2 uprv_getDefaultCodepage(void); * This function can call setlocale() on Unix platforms. Please read the * platform documentation on setlocale() before calling this function. * @return the default locale ID string - * @stable + * @stable ICU 2.0 */ U_CAPI const char* U_EXPORT2 uprv_getDefaultLocaleID(void); @@ -236,7 +236,7 @@ U_CAPI double U_EXPORT2 uprv_nextDouble(double d, UBool positive); /** * Filesystem file and path separator characters. * Example: '/' and ':' on Unix, '\\' and ';' on Windows. - * @stable + * @stable ICU 2.0 */ #ifdef XP_MAC # define U_FILE_SEP_CHAR ':' @@ -269,7 +269,7 @@ U_CAPI double U_EXPORT2 uprv_nextDouble(double d, UBool positive); * Unicode characters. * @param length The number of characters to convert; this may * include the terminating NUL. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 u_charsToUChars(const char *cs, UChar *us, int32_t length); @@ -289,7 +289,7 @@ u_charsToUChars(const char *cs, UChar *us, int32_t length); * character bytes. * @param length The number of characters to convert; this may * include the terminating NUL. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 u_UCharsToChars(const UChar *us, char *cs, int32_t length); diff --git a/icu4c/source/common/unicode/rbbi.h b/icu4c/source/common/unicode/rbbi.h index 053ea305a8f..4bcab7ede61 100644 --- a/icu4c/source/common/unicode/rbbi.h +++ b/icu4c/source/common/unicode/rbbi.h @@ -141,7 +141,7 @@ public: * Copy constructor. Will produce a break iterator with the same behavior, * and which iterates over the same text, as the one passed in. * @param that The RuleBasedBreakIterator passed to be copied - * @stable + * @stable ICU 2.0 */ RuleBasedBreakIterator(const RuleBasedBreakIterator& that); @@ -158,7 +158,7 @@ public: UErrorCode &status); /** * Destructor - * @stable + * @stable ICU 2.0 */ virtual ~RuleBasedBreakIterator(); @@ -167,7 +167,7 @@ public: * and iterate over the same text, as the one passed in. * @param that The RuleBasedBreakItertor passed in * @return the newly created RuleBasedBreakIterator - * @stable + * @stable ICU 2.0 */ RuleBasedBreakIterator& operator=(const RuleBasedBreakIterator& that); @@ -177,7 +177,7 @@ public: * @param that The BreakIterator to be compared for equality * @Return TRUE if both BreakIterators are of the * same class, have the same behavior, and iterate over the same text. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const BreakIterator& that) const; @@ -186,7 +186,7 @@ public: * and vice versa. * @param that The BreakIterator to be compared for inequality * @return TRUE if both BreakIterators are not same. - * @stable + * @stable ICU 2.0 */ UBool operator!=(const BreakIterator& that) const; @@ -197,21 +197,21 @@ public: * will correctly clone (copy) a derived class. * clone() is thread safe. Multiple threads may simultaeneously * clone the same source break iterator. - * @stable + * @stable ICU 2.0 */ virtual BreakIterator* clone() const; /** * Compute a hash code for this BreakIterator * @return A hash code - * @stable + * @stable ICU 2.0 */ virtual int32_t hashCode(void) const; /** * Returns the description used to create this iterator * @return the description used to create this iterator - * @stable + * @stable ICU 2.0 */ virtual const UnicodeString& getRules(void) const; @@ -225,7 +225,7 @@ public: * Changing the state of this iterator can have undefined consequences. If * you need to change it, clone it first. * @return An iterator over the text being analyzed. - * @stable + * @stable ICU 2.0 */ virtual const CharacterIterator& getText(void) const; @@ -235,7 +235,7 @@ public: * the current iteration position to the beginning of the text. * @param newText An iterator over the text to analyze. The BreakIterator * takes ownership of the character iterator. The caller MUST NOT delete it! - * @stable + * @stable ICU 2.0 */ virtual void adoptText(CharacterIterator* newText); @@ -243,7 +243,7 @@ public: * Set the iterator to analyze a new piece of text. This function resets * the current iteration position to the beginning of the text. * @param newText The text to analyze. - * @stable + * @stable ICU 2.0 */ virtual void setText(const UnicodeString& newText); @@ -251,7 +251,7 @@ public: * Sets the current iteration position to the beginning of the text. * (i.e., the CharacterIterator's starting offset). * @return The offset of the beginning of the text. - * @stable + * @stable ICU 2.0 */ virtual int32_t first(void); @@ -259,7 +259,7 @@ public: * Sets the current iteration position to the end of the text. * (i.e., the CharacterIterator's ending offset). * @return The text's past-the-end offset. - * @stable + * @stable ICU 2.0 */ virtual int32_t last(void); @@ -271,21 +271,21 @@ public: * (negative is backwards, and positive is forwards). * @return The character offset of the boundary position n boundaries away from * the current one. - * @stable + * @stable ICU 2.0 */ virtual int32_t next(int32_t n); /** * Advances the iterator to the next boundary position. * @return The position of the first boundary after this one. - * @stable + * @stable ICU 2.0 */ virtual int32_t next(void); /** * Moves the iterator backwards, to the last boundary preceding this one. * @return The position of the last boundary position preceding this one. - * @stable + * @stable ICU 2.0 */ virtual int32_t previous(void); @@ -294,7 +294,7 @@ public: * the specified position. * @param offset The position from which to begin searching for a break position. * @return The position of the first break after the current position. - * @stable + * @stable ICU 2.0 */ virtual int32_t following(int32_t offset); @@ -303,7 +303,7 @@ public: * specified position. * @param offset The position to begin searching for a break from. * @return The position of the last boundary before the starting position. - * @stable + * @stable ICU 2.0 */ virtual int32_t preceding(int32_t offset); @@ -313,14 +313,14 @@ public: * or after "offset". * @param offset the offset to check. * @return True if "offset" is a boundary position. - * @stable + * @stable ICU 2.0 */ virtual UBool isBoundary(int32_t offset); /** * Returns the current iteration position. * @return The current iteration position. - * @stable + * @stable ICU 2.0 */ virtual int32_t current(void) const; @@ -345,7 +345,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 */ inline virtual UClassID getDynamicClassID(void) const; @@ -358,7 +358,7 @@ public: * Derived::getStaticClassID()) ... * * @return The class ID for all objects of this class. - * @stable + * @stable ICU 2.0 */ inline static UClassID getStaticClassID(void); @@ -384,7 +384,7 @@ public: * @return Pointer to the clone object. This may differ from the stackBuffer * address if the byte alignment of the stack buffer was not suitable * or if the stackBuffer was too small to hold the clone. - * @stable + * @stable ICU 2.0 */ virtual BreakIterator * createBufferClone(void *stackBuffer, int32_t &BufferSize, diff --git a/icu4c/source/common/unicode/rep.h b/icu4c/source/common/unicode/rep.h index 1702786d8fc..217fb964f9c 100644 --- a/icu4c/source/common/unicode/rep.h +++ b/icu4c/source/common/unicode/rep.h @@ -62,14 +62,14 @@ class UnicodeString; * * If this is not the behavior, the subclass should document any differences. * @author Alan Liu - * @stable + * @stable ICU 2.0 */ class U_COMMON_API Replaceable : public UObject { public: /** * Destructor. - * @stable + * @stable ICU 2.0 */ virtual ~Replaceable(); @@ -135,7 +135,7 @@ public: * <= length(). * @param text the text to replace characters start * to limit - 1 - * @stable + * @stable ICU 2.0 */ virtual void handleReplaceBetween(int32_t start, int32_t limit, @@ -163,7 +163,7 @@ public: * start..limit-1 will be copied to dest. * Implementations of this method may assume that dest <= start || * dest >= limit. - * @stable + * @stable ICU 2.0 */ virtual void copy(int32_t start, int32_t limit, int32_t dest) = 0; diff --git a/icu4c/source/common/unicode/resbund.h b/icu4c/source/common/unicode/resbund.h index 26eb57b58d8..2c20efab9e4 100644 --- a/icu4c/source/common/unicode/resbund.h +++ b/icu4c/source/common/unicode/resbund.h @@ -68,7 +68,7 @@ U_NAMESPACE_BEGIN * * The ResourceBundle class is not suitable for subclassing. * - * @stable + * @stable ICU 2.0 */ class U_COMMON_API ResourceBundle : public UObject { public: @@ -98,7 +98,7 @@ public: * but nothing was found there, so 'de' was used. U_USING_DEFAULT_ERROR indicates that * the default locale data was used; neither the requested locale nor any of its * fall back locales could be found. - * @stable + * @stable ICU 2.0 */ ResourceBundle(const UnicodeString& path, const Locale& locale, @@ -109,7 +109,7 @@ public: * * @param path A path/basename for the data file(s) containing the bundle. * @param err A UErrorCode value - * @stable + * @stable ICU 2.0 */ ResourceBundle(const UnicodeString& path, UErrorCode& err); @@ -118,7 +118,7 @@ public: * Construct a resource bundle for the ICU root bundle. * * @param err A UErrorCode value - * @stable + * @stable ICU 2.0 */ ResourceBundle(UErrorCode &err); @@ -141,7 +141,7 @@ public: * NULL is used for ICU data. * @param locale The locale for which to open a resource bundle. * @param err A UErrorCode value - * @stable + * @stable ICU 2.0 */ ResourceBundle(const char* path, const Locale& locale, @@ -151,7 +151,7 @@ public: * Copy constructor. * * @param original The resource bundle to copy. - * @stable + * @stable ICU 2.0 */ ResourceBundle(const ResourceBundle &original); @@ -160,7 +160,7 @@ public: * * @param res A pointer to the C resource bundle. * @param status A UErrorCode value. - * @stable + * @stable ICU 2.0 */ ResourceBundle(UResourceBundle *res, UErrorCode &status); @@ -169,7 +169,7 @@ public: * Assignment operator. * * @param other The resource bundle to copy. - * @stable + * @stable ICU 2.0 */ ResourceBundle& operator=(const ResourceBundle& other); @@ -184,7 +184,7 @@ public: * the number of child resources. * * @return number of resources in a given resource. - * @stable + * @stable ICU 2.0 */ int32_t getSize(void) const; @@ -197,7 +197,7 @@ public: * could be a warning * e.g.: U_USING_FALLBACK_WARNING,U_USING_DEFAULT_WARNING * @return a pointer to a zero-terminated UChar array which lives in a memory mapped/DLL file. - * @stable + * @stable ICU 2.0 */ UnicodeString getString(UErrorCode& status) const; @@ -213,7 +213,7 @@ public: * could be a warning * e.g.: U_USING_FALLBACK_WARNING,U_USING_DEFAULT_WARNING * @return a pointer to a chunk of unsigned bytes which live in a memory mapped/DLL file. - * @stable + * @stable ICU 2.0 */ const uint8_t* getBinary(int32_t& len, UErrorCode& status) const; @@ -229,7 +229,7 @@ public: * could be a warning * e.g.: U_USING_FALLBACK_WARNING,U_USING_DEFAULT_WARNING * @return a pointer to a vector of integers that lives in a memory mapped/DLL file. - * @stable + * @stable ICU 2.0 */ const int32_t* getIntVector(int32_t& len, UErrorCode& status) const; @@ -243,7 +243,7 @@ public: * could be a warning * e.g.: U_USING_FALLBACK_WARNING,U_USING_DEFAULT_WARNING * @return an unsigned integer value - * @stable + * @stable ICU 2.0 */ uint32_t getUInt(UErrorCode& status) const; @@ -257,7 +257,7 @@ public: * could be a warning * e.g.: U_USING_FALLBACK_WARNING,U_USING_DEFAULT_WARNING * @return a signed integer value - * @stable + * @stable ICU 2.0 */ int32_t getInt(UErrorCode& status) const; @@ -266,7 +266,7 @@ public: * Checks whether the resource has another element to iterate over. * * @return TRUE if there are more elements, FALSE if there is no more elements - * @stable + * @stable ICU 2.0 */ UBool hasNext(void) const; @@ -274,7 +274,7 @@ public: /** * Resets the internal context of a resource so that iteration starts from the first element. * - * @stable + * @stable ICU 2.0 */ void resetIterator(void); @@ -284,7 +284,7 @@ public: * those that are members of a table. * * @return a key associated to this resource, or NULL if it doesn't have a key - * @stable + * @stable ICU 2.0 */ const char* getKey(void); @@ -294,7 +294,7 @@ public: * Same as getLocale().getName() . * * @return the locale ID of the resource bundle as a string - * @stable + * @stable ICU 2.0 */ const char* getName(void); @@ -304,7 +304,7 @@ public: * Returns the type of a resource. Available types are defined in enum UResType * * @return type of the given resource. - * @stable + * @stable ICU 2.0 */ UResType getType(void); @@ -314,7 +314,7 @@ public: * * @param status fills in the outgoing error code * @return ResourceBundle object. - * @stable + * @stable ICU 2.0 */ ResourceBundle getNext(UErrorCode& status); @@ -325,7 +325,7 @@ public: * * @param status fills in the outgoing error code * @return an UnicodeString object. - * @stable + * @stable ICU 2.0 */ UnicodeString getNextString(UErrorCode& status); @@ -337,7 +337,7 @@ public: * @param key fill in for key associated with this string * @param status fills in the outgoing error code * @return an UnicodeString object. - * @stable + * @stable ICU 2.0 */ UnicodeString getNextString(const char ** key, @@ -349,7 +349,7 @@ public: * @param index an index to the wanted resource. * @param status fills in the outgoing error code * @return ResourceBundle object. If there is an error, resource is invalid. - * @stable + * @stable ICU 2.0 */ ResourceBundle get(int32_t index, @@ -361,7 +361,7 @@ public: * @param index an index to the wanted string. * @param status fills in the outgoing error code * @return an UnicodeString object. If there is an error, string is bogus - * @stable + * @stable ICU 2.0 */ UnicodeString getStringEx(int32_t index, @@ -374,7 +374,7 @@ public: * @param key a key associated with the wanted resource * @param status fills in the outgoing error code. * @return ResourceBundle object. If there is an error, resource is invalid. - * @stable + * @stable ICU 2.0 */ ResourceBundle get(const char* key, @@ -387,7 +387,7 @@ public: * @param key a key associated with the wanted string * @param status fills in the outgoing error code * @return an UnicodeString object. If there is an error, string is bogus - * @stable + * @stable ICU 2.0 */ UnicodeString getStringEx(const char* key, @@ -400,7 +400,7 @@ public: * @return A version number string as specified in the resource bundle or its parent. * The caller does not own this string. * @see getVersion - * @stable + * @stable ICU 2.0 */ const char* getVersionNumber(void) const; @@ -410,7 +410,7 @@ public: * * @param versionInfo A UVersionInfo array that is filled with the version number * as specified in the resource bundle or its parent. - * @stable + * @stable ICU 2.0 */ void getVersion(UVersionInfo versionInfo) const; @@ -419,7 +419,7 @@ public: * Return the Locale associated with this ResourceBundle. * * @return a Locale object - * @stable + * @stable ICU 2.0 */ const Locale& getLocale(void) const; diff --git a/icu4c/source/common/unicode/schriter.h b/icu4c/source/common/unicode/schriter.h index 6ac04d66952..12d94b3b6d2 100644 --- a/icu4c/source/common/unicode/schriter.h +++ b/icu4c/source/common/unicode/schriter.h @@ -33,7 +33,7 @@ U_NAMESPACE_BEGIN * compare equal). * @see CharacterIterator * @see ForwardCharacterIterator - * @stable + * @stable ICU 2.0 */ class U_COMMON_API StringCharacterIterator : public UCharCharacterIterator { public: @@ -42,7 +42,7 @@ public: * The UnicodeString object is copied. * The iteration range is the whole string, and the starting position is 0. * @param textStr The unicode string used to create an iterator - * @stable + * @stable ICU 2.0 */ StringCharacterIterator(const UnicodeString& textStr); @@ -53,7 +53,7 @@ public: * iteration range, the behavior of this object is undefined. * @textStr The unicode string used to create an iterator * @textPos The starting position of the iteration - * @stable + * @stable ICU 2.0 */ StringCharacterIterator(const UnicodeString& textStr, int32_t textPos); @@ -72,7 +72,7 @@ public: * @param textBegin The begin position of the iteration range * @param textEnd The end position of the iteration range * @param textPos The starting position of the iteration - * @stable + * @stable ICU 2.0 */ StringCharacterIterator(const UnicodeString& textStr, int32_t textBegin, @@ -85,13 +85,13 @@ public: * same as "that"'s current position. * The UnicodeString object in "that" is copied. * @param that The StringCharacterIterator to be copied - * @stable + * @stable ICU 2.0 */ StringCharacterIterator(const StringCharacterIterator& that); /** * Destructor. - * @stable + * @stable ICU 2.0 */ virtual ~StringCharacterIterator(); @@ -101,7 +101,7 @@ public: * character within that string as "that" does. * @param that The object to be copied. * @return the newly created object. - * @stable + * @stable ICU 2.0 */ StringCharacterIterator& operator=(const StringCharacterIterator& that); @@ -112,7 +112,7 @@ public: * @param that The ForwardCharacterIterator to be compared for equality * @return true if the iterators iterate over the same range of the * same string and are pointing at the same character. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const ForwardCharacterIterator& that) const; @@ -121,14 +121,14 @@ public: * character in the same range of the same string as this one. The * caller must delete the new iterator. * @return the newly cloned object. - * @stable + * @stable ICU 2.0 */ virtual CharacterIterator* clone(void) const; /** * Sets the iterator to iterate over the provided string. * @param newText The string to be iterated over - * @stable + * @stable ICU 2.0 */ void setText(const UnicodeString& newText); @@ -137,14 +137,14 @@ public: * referred to by "result". Even if this iterator iterates across * only a part of this string, the whole string is copied. * @param result Receives a copy of the text under iteration. - * @stable + * @stable ICU 2.0 */ virtual void getText(UnicodeString& result); /** * Return a class ID for this object (not really public) * @return a class ID for this object. - * @stable + * @stable ICU 2.0 */ virtual UClassID getDynamicClassID(void) const { return getStaticClassID(); } @@ -152,7 +152,7 @@ public: /** * Return a class ID for this class (not really public) * @return a class ID for this class - * @stable + * @stable ICU 2.0 */ static UClassID getStaticClassID(void) { return (UClassID)(&fgClassID); } @@ -163,7 +163,7 @@ protected: * Sets the iterator to iterate over the provided string. * @param newText The string to be iterated over * @param newTextLength The length of the String - * @stable + * @stable ICU 2.0 */ void setText(const UChar* newText, int32_t newTextLength); diff --git a/icu4c/source/common/unicode/ubidi.h b/icu4c/source/common/unicode/ubidi.h index aa6f21b33d5..63f0d7662df 100644 --- a/icu4c/source/common/unicode/ubidi.h +++ b/icu4c/source/common/unicode/ubidi.h @@ -334,38 +334,38 @@ * @see UBIDI_DEFAULT_RTL * @see UBIDI_LEVEL_OVERRIDE * @see UBIDI_MAX_EXPLICIT_LEVEL - * @stable + * @stable ICU 2.0 */ typedef uint8_t UBiDiLevel; /** Paragraph level setting. * If there is no strong character, then set the paragraph level to 0 (left-to-right). - * @stable + * @stable ICU 2.0 */ #define UBIDI_DEFAULT_LTR 0xfe /** Paragraph level setting. * If there is no strong character, then set the paragraph level to 1 (right-to-left). - * @stable + * @stable ICU 2.0 */ #define UBIDI_DEFAULT_RTL 0xff /** * Maximum explicit embedding level. * (The maximum resolved level can be up to UBIDI_MAX_EXPLICIT_LEVEL+1). - * @stable + * @stable ICU 2.0 */ #define UBIDI_MAX_EXPLICIT_LEVEL 61 /** Bit flag for level input. * Overrides directional properties. - * @stable + * @stable ICU 2.0 */ #define UBIDI_LEVEL_OVERRIDE 0x80 /** * @memo UBiDiDirection values indicate the text direction. - * @stable + * @stable ICU 2.0 */ enum UBiDiDirection { /** @memo All left-to-right text. This is a 0 value. @stable */ @@ -387,7 +387,7 @@ typedef enum UBiDiDirection UBiDiDirection; * such a paragraph.

* Reordering can be done on a line, or on a paragraph which is * then interpreted as one single line. - * @stable + * @stable ICU 2.0 */ struct UBiDi; @@ -406,7 +406,7 @@ typedef struct UBiDi UBiDi; * internal structures as necessary. * * @return An empty UBiDi object. - * @stable + * @stable ICU 2.0 */ U_CAPI UBiDi * U_EXPORT2 ubidi_open(void); @@ -444,7 +444,7 @@ ubidi_open(void); * which must not indicate a failure before the function call. * * @return An empty UBiDi object with preallocated memory. - * @stable + * @stable ICU 2.0 */ U_CAPI UBiDi * U_EXPORT2 ubidi_openSized(int32_t maxLength, int32_t maxRunCount, UErrorCode *pErrorCode); @@ -465,7 +465,7 @@ ubidi_openSized(int32_t maxLength, int32_t maxRunCount, UErrorCode *pErrorCode); * * @see ubidi_setPara * @see ubidi_setLine - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ubidi_close(UBiDi *pBiDi); @@ -504,7 +504,7 @@ ubidi_close(UBiDi *pBiDi); * * @see ubidi_setPara * @see ubidi_writeReordered - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ubidi_setInverse(UBiDi *pBiDi, UBool isInverse); @@ -516,7 +516,7 @@ ubidi_setInverse(UBiDi *pBiDi, UBool isInverse); * @return TRUE if the BiDi object set to perform the inverse BiDi algorithm * * @see ubidi_setInverse - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 ubidi_isInverse(UBiDi *pBiDi); @@ -590,7 +590,7 @@ ubidi_isInverse(UBiDi *pBiDi); * * @param pErrorCode must be a valid pointer to an error code value, * which must not indicate a failure before the function call. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ubidi_setPara(UBiDi *pBiDi, const UChar *text, int32_t length, @@ -638,7 +638,7 @@ ubidi_setPara(UBiDi *pBiDi, const UChar *text, int32_t length, * which must not indicate a failure before the function call. * * @see ubidi_setPara - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ubidi_setLine(const UBiDi *pParaBiDi, @@ -656,7 +656,7 @@ ubidi_setLine(const UBiDi *pParaBiDi, * and which direction, or if it is mixed-directional. * * @see UBiDiDirection - * @stable + * @stable ICU 2.0 */ U_CAPI UBiDiDirection U_EXPORT2 ubidi_getDirection(const UBiDi *pBiDi); @@ -670,7 +670,7 @@ ubidi_getDirection(const UBiDi *pBiDi); * * @see ubidi_setPara * @see ubidi_setLine - * @stable + * @stable ICU 2.0 */ U_CAPI const UChar * U_EXPORT2 ubidi_getText(const UBiDi *pBiDi); @@ -681,7 +681,7 @@ ubidi_getText(const UBiDi *pBiDi); * @param pBiDi is the paragraph or line UBiDi object. * * @return The length of the text that the UBiDi object was created for. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ubidi_getLength(const UBiDi *pBiDi); @@ -694,7 +694,7 @@ ubidi_getLength(const UBiDi *pBiDi); * @return The paragraph level. * * @see UBiDiLevel - * @stable + * @stable ICU 2.0 */ U_CAPI UBiDiLevel U_EXPORT2 ubidi_getParaLevel(const UBiDi *pBiDi); @@ -709,7 +709,7 @@ ubidi_getParaLevel(const UBiDi *pBiDi); * @return The level for the character at charIndex. * * @see UBiDiLevel - * @stable + * @stable ICU 2.0 */ U_CAPI UBiDiLevel U_EXPORT2 ubidi_getLevelAt(const UBiDi *pBiDi, int32_t charIndex); @@ -729,7 +729,7 @@ ubidi_getLevelAt(const UBiDi *pBiDi, int32_t charIndex); * or NULL if an error occurs. * * @see UBiDiLevel - * @stable + * @stable ICU 2.0 */ U_CAPI const UBiDiLevel * U_EXPORT2 ubidi_getLevels(UBiDi *pBiDi, UErrorCode *pErrorCode); @@ -754,7 +754,7 @@ ubidi_getLevels(UBiDi *pBiDi, UErrorCode *pErrorCode); * @param pLevel will receive the level of the run. * This pointer can be NULL if this * value is not necessary. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ubidi_getLogicalRun(const UBiDi *pBiDi, int32_t logicalStart, @@ -774,7 +774,7 @@ ubidi_getLogicalRun(const UBiDi *pBiDi, int32_t logicalStart, * which must not indicate a failure before the function call. * * @return The number of runs. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ubidi_countRuns(UBiDi *pBiDi, UErrorCode *pErrorCode); @@ -828,7 +828,7 @@ ubidi_countRuns(UBiDi *pBiDi, UErrorCode *pErrorCode); * Note that in right-to-left runs, code like this places * modifier letters before base characters and second surrogates * before first ones. - * @stable + * @stable ICU 2.0 */ U_CAPI UBiDiDirection U_EXPORT2 ubidi_getVisualRun(UBiDi *pBiDi, int32_t runIndex, @@ -855,7 +855,7 @@ ubidi_getVisualRun(UBiDi *pBiDi, int32_t runIndex, * * @see ubidi_getLogicalMap * @see ubidi_getLogicalIndex - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ubidi_getVisualIndex(UBiDi *pBiDi, int32_t logicalIndex, UErrorCode *pErrorCode); @@ -879,7 +879,7 @@ ubidi_getVisualIndex(UBiDi *pBiDi, int32_t logicalIndex, UErrorCode *pErrorCode) * * @see ubidi_getVisualMap * @see ubidi_getVisualIndex - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ubidi_getLogicalIndex(UBiDi *pBiDi, int32_t visualIndex, UErrorCode *pErrorCode); @@ -900,7 +900,7 @@ ubidi_getLogicalIndex(UBiDi *pBiDi, int32_t visualIndex, UErrorCode *pErrorCode) * * @see ubidi_getVisualMap * @see ubidi_getVisualIndex - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ubidi_getLogicalMap(UBiDi *pBiDi, int32_t *indexMap, UErrorCode *pErrorCode); @@ -921,7 +921,7 @@ ubidi_getLogicalMap(UBiDi *pBiDi, int32_t *indexMap, UErrorCode *pErrorCode); * * @see ubidi_getLogicalMap * @see ubidi_getLogicalIndex - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ubidi_getVisualMap(UBiDi *pBiDi, int32_t *indexMap, UErrorCode *pErrorCode); @@ -944,7 +944,7 @@ ubidi_getVisualMap(UBiDi *pBiDi, int32_t *indexMap, UErrorCode *pErrorCode); * indexes which will reflect the reordering of the characters. * The array does not need to be initialized.

* The index map will result in indexMap[logicalIndex]==visualIndex. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ubidi_reorderLogical(const UBiDiLevel *levels, int32_t length, int32_t *indexMap); @@ -967,7 +967,7 @@ ubidi_reorderLogical(const UBiDiLevel *levels, int32_t length, int32_t *indexMap * indexes which will reflect the reordering of the characters. * The array does not need to be initialized.

* The index map will result in indexMap[visualIndex]==logicalIndex. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ubidi_reorderVisual(const UBiDiLevel *levels, int32_t length, int32_t *indexMap); @@ -984,7 +984,7 @@ ubidi_reorderVisual(const UBiDiLevel *levels, int32_t length, int32_t *indexMap) * which will be filled with the inverse mapping. * * @param length is the length of each array. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ubidi_invertMap(const int32_t *srcMap, int32_t *destMap, int32_t length); @@ -996,7 +996,7 @@ ubidi_invertMap(const int32_t *srcMap, int32_t *destMap, int32_t length); * keep combining characters after their base characters in RTL runs * * @see ubidi_writeReordered - * @stable + * @stable ICU 2.0 */ #define UBIDI_KEEP_BASE_COMBINING 1 @@ -1006,7 +1006,7 @@ ubidi_invertMap(const int32_t *srcMap, int32_t *destMap, int32_t length); * by their mirror-image mappings * * @see ubidi_writeReordered - * @stable + * @stable ICU 2.0 */ #define UBIDI_DO_MIRRORING 2 @@ -1017,7 +1017,7 @@ ubidi_invertMap(const int32_t *srcMap, int32_t *destMap, int32_t length); * * @see ubidi_setInverse * @see ubidi_writeReordered - * @stable + * @stable ICU 2.0 */ #define UBIDI_INSERT_LRM_FOR_NUMERIC 4 @@ -1027,7 +1027,7 @@ ubidi_invertMap(const int32_t *srcMap, int32_t *destMap, int32_t length); * (this does not affect UBIDI_INSERT_LRM_FOR_NUMERIC) * * @see ubidi_writeReordered - * @stable + * @stable ICU 2.0 */ #define UBIDI_REMOVE_BIDI_CONTROLS 8 @@ -1043,7 +1043,7 @@ ubidi_invertMap(const int32_t *srcMap, int32_t *destMap, int32_t length); * is designed for RTL scripts and stores text in reverse order.

* * @see ubidi_writeReordered - * @stable + * @stable ICU 2.0 */ #define UBIDI_OUTPUT_REVERSE 16 @@ -1102,7 +1102,7 @@ ubidi_invertMap(const int32_t *srcMap, int32_t *destMap, int32_t length); * which must not indicate a failure before the function call. * * @return The length of the output string. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ubidi_writeReordered(UBiDi *pBiDi, @@ -1155,7 +1155,7 @@ ubidi_writeReordered(UBiDi *pBiDi, * which must not indicate a failure before the function call. * * @return The length of the output string. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ubidi_writeReverse(const UChar *src, int32_t srcLength, diff --git a/icu4c/source/common/unicode/ubrk.h b/icu4c/source/common/unicode/ubrk.h index b49b2f686f4..77c7ec051d8 100644 --- a/icu4c/source/common/unicode/ubrk.h +++ b/icu4c/source/common/unicode/ubrk.h @@ -243,7 +243,7 @@ typedef enum UWordBreak { * @param status A UErrorCode to receive any errors. * @return A UBreakIterator for the specified locale. * @see ubrk_openRules - * @stable + * @stable ICU 2.0 */ U_CAPI UBreakIterator* U_EXPORT2 ubrk_open(UBreakIteratorType type, @@ -289,7 +289,7 @@ ubrk_openRules(const UChar *rules, * @param status to indicate whether the operation went on smoothly or there were errors * An informational status value, U_SAFECLONE_ALLOCATED_ERROR, is used if any allocations were necessary. * @return pointer to the new clone - * @stable + * @stable ICU 2.0 */ U_CAPI UBreakIterator * U_EXPORT2 ubrk_safeClone( @@ -304,7 +304,7 @@ ubrk_safeClone( * Close a UBreakIterator. * Once closed, a UBreakIterator may no longer be used. * @param bi The break iterator to close. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ubrk_close(UBreakIterator *bi); @@ -315,7 +315,7 @@ ubrk_close(UBreakIterator *bi); * @param text The text to be set * @param textLength The length of the text * @param status The error code - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ubrk_setText(UBreakIterator* bi, @@ -329,7 +329,7 @@ ubrk_setText(UBreakIterator* bi, * @param bi The break iterator to use. * @return The character index most recently returned by \Ref{ubrk_next}, \Ref{ubrk_previous}, * \Ref{ubrk_first}, or \Ref{ubrk_last}. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ubrk_current(const UBreakIterator *bi); @@ -341,7 +341,7 @@ ubrk_current(const UBreakIterator *bi); * @return The character index of the next text boundary, or UBRK_DONE * if all text boundaries have been returned. * @see ubrk_previous - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ubrk_next(UBreakIterator *bi); @@ -353,7 +353,7 @@ ubrk_next(UBreakIterator *bi); * @return The character index of the preceding text boundary, or UBRK_DONE * if all text boundaries have been returned. * @see ubrk_next - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ubrk_previous(UBreakIterator *bi); @@ -364,7 +364,7 @@ ubrk_previous(UBreakIterator *bi); * @param bi The break iterator to use. * @return The character index of the first character in the text being scanned. * @see ubrk_last - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ubrk_first(UBreakIterator *bi); @@ -377,7 +377,7 @@ ubrk_first(UBreakIterator *bi); * @return The character offset immediately beyond the last character in the * text being scanned. * @see ubrk_first - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ubrk_last(UBreakIterator *bi); @@ -389,7 +389,7 @@ ubrk_last(UBreakIterator *bi); * @param offset The offset to begin scanning. * @return The text boundary preceding offset, or UBRK_DONE. * @see ubrk_following - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ubrk_preceding(UBreakIterator *bi, @@ -402,7 +402,7 @@ ubrk_preceding(UBreakIterator *bi, * @param offset The offset to begin scanning. * @return The text boundary following offset, or UBRK_DONE. * @see ubrk_preceding - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ubrk_following(UBreakIterator *bi, @@ -415,7 +415,7 @@ ubrk_following(UBreakIterator *bi, * @param index The index of the desired locale. * @return A locale for which number text breaking information is available, or 0 if none. * @see ubrk_countAvailable -* @stable +* @stable ICU 2.0 */ U_CAPI const char* U_EXPORT2 ubrk_getAvailable(int32_t index); @@ -426,7 +426,7 @@ ubrk_getAvailable(int32_t index); * calls to \Ref{ubrk_getAvailable}. * @return The number of locales for which text breaking information is available. * @see ubrk_getAvailable -* @stable +* @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ubrk_countAvailable(void); @@ -439,7 +439,7 @@ ubrk_countAvailable(void); * @param bi The break iterator to use. * @param offset the offset to check. * @return True if "offset" is a boundary position. -* @stable +* @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 ubrk_isBoundary(UBreakIterator *bi, int32_t offset); diff --git a/icu4c/source/common/unicode/uchar.h b/icu4c/source/common/unicode/uchar.h index e60edcbab5f..8c76c82634c 100644 --- a/icu4c/source/common/unicode/uchar.h +++ b/icu4c/source/common/unicode/uchar.h @@ -37,7 +37,7 @@ U_CDECL_BEGIN * Call u_getUnicodeVersion to get the actual Unicode version of the data. * * @see u_getUnicodeVersion - * @stable + * @stable ICU 2.0 */ #define U_UNICODE_VERSION "3.2" @@ -342,7 +342,7 @@ typedef enum UProperty { /** * Data for enumerated Unicode general category types. * See http://www.unicode.org/Public/UNIDATA/UnicodeData.html . - * @stable + * @stable ICU 2.0 */ typedef enum UCharCategory { @@ -491,7 +491,7 @@ typedef enum UCharCategory /** * This specifies the language directional property of a character set. - * @stable + * @stable ICU 2.0 */ typedef enum UCharDirection { /** See note !!. Comments of the form "EN" are read by genpname. */ @@ -541,7 +541,7 @@ typedef enum UCharDirection { /** * Constants for Unicode blocks, generated from Unicode Data file Blocks.txt * These are the same values as Unicode::EUnicodeScript - * @stable + * @stable ICU 2.0 */ enum UBlockCode { /** @stable */ @@ -567,7 +567,7 @@ enum UBlockCode { /** * Unicode 3.2 renames this block to "Greek and Coptic". - * @stable + * @stable ICU 2.0 */ UBLOCK_GREEK =8, /*[0370]*/ @@ -675,7 +675,7 @@ enum UBlockCode { /** * Unicode 3.2 renames this block to "Combining Diacritical Marks for Symbols". - * @stable + * @stable ICU 2.0 */ UBLOCK_COMBINING_MARKS_FOR_SYMBOLS =43, /*[20D0]*/ @@ -788,7 +788,7 @@ enum UBlockCode { * Unicode 3.2 renames the block for the BMP PUA to "Private Use Area" and * adds separate blocks for the supplementary PUAs. * - * @stable + * @stable ICU 2.0 */ UBLOCK_PRIVATE_USE = 78, /** @@ -798,7 +798,7 @@ enum UBlockCode { * Unicode 3.2 renames the block for the BMP PUA to "Private Use Area" and * adds separate blocks for the supplementary PUAs. * - * @stable + * @stable ICU 2.0 */ UBLOCK_PRIVATE_USE_AREA =UBLOCK_PRIVATE_USE, /*[E000]*/ @@ -1122,7 +1122,7 @@ typedef enum UEastAsianWidth { * Unicode code point a unique name. * * @see u_charName - * @stable + * @stable ICU 2.0 */ typedef enum UCharNameChoice { U_UNICODE_CHAR_NAME, @@ -1529,7 +1529,7 @@ u_getNumericValue(UChar32 c); * @see u_isupper * @see u_istitle * @see u_islower - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 u_islower(UChar32 c); @@ -1543,7 +1543,7 @@ u_islower(UChar32 c); * @see u_islower * @see u_istitle * @see u_tolower - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 u_isupper(UChar32 c); @@ -1557,7 +1557,7 @@ u_isupper(UChar32 c); * @see u_isupper * @see u_islower * @see u_totitle - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 u_istitle(UChar32 c); @@ -1567,7 +1567,7 @@ u_istitle(UChar32 c); * * @param c the character to be tested * @return true if the character is a digit; false otherwise. - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 u_isdigit(UChar32 c); @@ -1578,7 +1578,7 @@ u_isdigit(UChar32 c); * * @param c the character to be tested * @return true if the character is a letter or a digit; false otherwise. - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 u_isalnum(UChar32 c); @@ -1596,7 +1596,7 @@ u_isalnum(UChar32 c); * @see u_isupper * @see u_islower * @see u_istitle - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 u_isdefined(UChar32 c); @@ -1610,7 +1610,7 @@ u_isdefined(UChar32 c); * * @see u_isdigit * @see u_isalnum - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 u_isalpha(UChar32 c); @@ -1620,7 +1620,7 @@ u_isalpha(UChar32 c); * * @param c the character to be tested * @return true if the character is a space character; false otherwise. - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 u_isspace(UChar32 c); @@ -1651,7 +1651,7 @@ u_isspace(UChar32 c); * @return true if the character is an ICU whitespace character; * false otherwise. * @see #u_isspace - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 u_isWhitespace(UChar32 c); @@ -1669,7 +1669,7 @@ u_isWhitespace(UChar32 c); * @return true if the Unicode character is a control character; false otherwise. * * @see u_isprint - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 u_iscntrl(UChar32 c); @@ -1683,7 +1683,7 @@ u_iscntrl(UChar32 c); * @return true if the Unicode character is a printable character; false otherwise. * * @see u_iscntrl - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 u_isprint(UChar32 c); @@ -1697,7 +1697,7 @@ u_isprint(UChar32 c); * * @see u_isalpha * @see u_isdigit - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 u_isbase(UChar32 c); @@ -1712,7 +1712,7 @@ u_isbase(UChar32 c); * @return the linguistic direction property of a character. * @see UCharDirection * @see UCharDirection - * @stable + * @stable ICU 2.0 */ U_CAPI UCharDirection U_EXPORT2 u_charDirection(UChar32 c); @@ -1725,7 +1725,7 @@ u_charDirection(UChar32 c); * * @param c the character (code point, Unicode scalar value) to be tested * @return TRUE if the character has the "mirrored" property - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 u_isMirrored(UChar32 c); @@ -1744,7 +1744,7 @@ u_isMirrored(UChar32 c); * @return another Unicode code point that may serve as a mirror-image * substitute, or c itself if there is no such mapping or c * does not have the "mirrored" property - * @stable + * @stable ICU 2.0 */ U_CAPI UChar32 U_EXPORT2 u_charMirror(UChar32 c); @@ -1818,7 +1818,7 @@ u_charCellWidth(UChar32 c); * @param c the character to be tested * @return a value of type int, the character category. * @see UCharCategory - * @stable + * @stable ICU 2.0 */ U_CAPI int8_t U_EXPORT2 u_charType(UChar32 c); @@ -1882,7 +1882,7 @@ u_enumCharTypes(UCharEnumTypeRange *enumRange, const void *context); * * @param c the code point of the character * @return the combining class of the character - * @stable + * @stable ICU 2.0 */ U_CAPI uint8_t U_EXPORT2 u_getCombiningClass(UChar32 c); @@ -1893,7 +1893,7 @@ u_getCombiningClass(UChar32 c); * @param c the decimal digit character for which to get the numeric value * @return the numeric value of c in decimal radix. This method returns * -1 if c is not a valid digit character. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_charDigitValue(UChar32 c); @@ -1904,7 +1904,7 @@ u_charDigitValue(UChar32 c); * @param ch The character to be tested * @return the Unicode allocation block that contains the character * @see #UBlockCode - * @stable + * @stable ICU 2.0 */ U_CAPI UBlockCode U_EXPORT2 ublock_getCode(UChar32 ch); @@ -1939,7 +1939,7 @@ ublock_getCode(UChar32 ch); * @see UCharNameChoice * @see u_charFromName * @see u_enumCharNames - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_charName(UChar32 code, UCharNameChoice nameChoice, @@ -2181,7 +2181,7 @@ u_getPropertyValueEnum(UProperty property, * FALSE otherwise. * @see u_isalpha * @see u_isIDPart - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 u_isIDStart(UChar32 c); @@ -2208,7 +2208,7 @@ u_isIDStart(UChar32 c); * FALSE otherwise. * @see u_isIDIgnorable * @see u_isIDStart - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 u_isIDPart(UChar32 c); @@ -2235,7 +2235,7 @@ u_isIDPart(UChar32 c); * @return TRUE if the character may be part of a Unicode identifier; * FALSE otherwise. * @see u_isIDPart - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 u_isIDIgnorable(UChar32 c); @@ -2258,7 +2258,7 @@ u_isIDIgnorable(UChar32 c); * @see u_isJavaIDPart * @see u_isalpha * @see u_isIDStart - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 u_isJavaIDStart(UChar32 c); @@ -2289,7 +2289,7 @@ u_isJavaIDStart(UChar32 c); * @see u_isalpha * @see u_isdigit * @see u_isIDPart - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 u_isJavaIDPart(UChar32 c); @@ -2314,7 +2314,7 @@ u_isJavaIDPart(UChar32 c); * @param c the character to be converted * @return the lowercase equivalent of the character, if any; * otherwise the character itself. - * @stable + * @stable ICU 2.0 */ U_CAPI UChar32 U_EXPORT2 u_tolower(UChar32 c); @@ -2332,7 +2332,7 @@ u_tolower(UChar32 c); * @param c the character to be converted * @return the uppercase equivalent of the character, if any; * otherwise the character itself. - * @stable + * @stable ICU 2.0 */ U_CAPI UChar32 U_EXPORT2 u_toupper(UChar32 c); @@ -2349,7 +2349,7 @@ u_toupper(UChar32 c); * @param c the character to be converted * @return the titlecase equivalent of the character, if any; * otherwise the character itself. - * @stable + * @stable ICU 2.0 */ U_CAPI UChar32 U_EXPORT2 u_totitle(UChar32 c); @@ -2371,7 +2371,7 @@ u_totitle(UChar32 c); * are to be excluded for default mappings and * included for the Turkic-specific mappings. * - * @stable + * @stable ICU 2.0 */ #define U_FOLD_CASE_EXCLUDE_SPECIAL_I 1 @@ -2386,7 +2386,7 @@ u_totitle(UChar32 c); * @param options Either U_FOLD_CASE_DEFAULT or U_FOLD_CASE_EXCLUDE_SPECIAL_I * @return the case folding equivalent of the character, if any; * otherwise the character itself. - * @stable + * @stable ICU 2.0 */ U_CAPI UChar32 U_EXPORT2 u_foldCase(UChar32 c, uint32_t options); @@ -2424,7 +2424,7 @@ u_foldCase(UChar32 c, uint32_t options); * @see u_forDigit * @see u_charDigitValue * @see u_isdigit - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_digit(UChar32 ch, int8_t radix); @@ -2453,7 +2453,7 @@ u_digit(UChar32 ch, int8_t radix); * @see u_digit * @see u_charDigitValue * @see u_isdigit - * @stable + * @stable ICU 2.0 */ U_CAPI UChar32 U_EXPORT2 u_forDigit(int32_t digit, int8_t radix); @@ -2480,7 +2480,7 @@ u_charAge(UChar32 c, UVersionInfo versionArray); * for the Unicode standard that is currently used by ICU. For example, release "1.3.31.2" * is then represented as 0x01031F02. * @param versionArray the version # information, the result will be filled in - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 u_getUnicodeVersion(UVersionInfo info); diff --git a/icu4c/source/common/unicode/uchriter.h b/icu4c/source/common/unicode/uchriter.h index 951e443312c..ce91d8e564c 100644 --- a/icu4c/source/common/unicode/uchriter.h +++ b/icu4c/source/common/unicode/uchriter.h @@ -23,7 +23,7 @@ U_NAMESPACE_BEGIN * compare equal). * @see CharacterIterator * @see ForwardCharacterIterator - * @stable + * @stable ICU 2.0 */ class U_COMMON_API UCharCharacterIterator : public CharacterIterator { public: @@ -34,7 +34,7 @@ public: * destructor will not delete it). * @param textPtr The UChar array to be iterated over * @param length The length of the UChar array - * @stable + * @stable ICU 2.0 */ UCharCharacterIterator(const UChar* textPtr, int32_t length); @@ -49,7 +49,7 @@ public: * @param textPtr The UChar array to be iteratd over * @param length The length of the UChar array * @param position The starting position of the iteration - * @stable + * @stable ICU 2.0 */ UCharCharacterIterator(const UChar* textPtr, int32_t length, int32_t position); @@ -68,7 +68,7 @@ public: * @param textBegin The begin position of the iteration range * @param textEnd The end position of the iteration range * @param position The starting position of the iteration - * @stable + * @stable ICU 2.0 */ UCharCharacterIterator(const UChar* textPtr, int32_t length, int32_t textBegin, @@ -80,13 +80,13 @@ public: * of the same string as "that", and its initial position is the * same as "that"'s current position. * @param that The UCharCharacterIterator to be copied - * @stable + * @stable ICU 2.0 */ UCharCharacterIterator(const UCharCharacterIterator& that); /** * Destructor. - * @stable + * @stable ICU 2.0 */ ~UCharCharacterIterator(); @@ -96,7 +96,7 @@ public: * character within that string as "that" does. * @param that The object to be copied * @return the newly created object - * @stable + * @stable ICU 2.0 */ UCharCharacterIterator& operator=(const UCharCharacterIterator& that); @@ -107,14 +107,14 @@ public: * @param that The ForwardCharacterIterator used to be compared for equality * @return true if the iterators iterate over the same range of the * same string and are pointing at the same character. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const ForwardCharacterIterator& that) const; /** * Generates a hash code for this iterator. * @return the hash code. - * @stable + * @stable ICU 2.0 */ virtual int32_t hashCode(void) const; @@ -123,7 +123,7 @@ public: * character in the same range of the same string as this one. The * caller must delete the new iterator. * @return the CharacterIterator newly created - * @stable + * @stable ICU 2.0 */ virtual CharacterIterator* clone(void) const; @@ -132,7 +132,7 @@ public: * iteration range, and returns that code unit. * This can be used to begin an iteration with next(). * @return the first code unit in its iteration range. - * @stable + * @stable ICU 2.0 */ virtual UChar first(void); @@ -142,7 +142,7 @@ public: * to the second code unit. This is an alternative to setToStart() * for forward iteration with nextPostInc(). * @return the first code unit in its iteration range - * @stable + * @stable ICU 2.0 */ virtual UChar firstPostInc(void); @@ -153,7 +153,7 @@ public: * Note that an iteration with next32PostInc(), beginning with, * e.g., setToStart() or firstPostInc(), is more efficient. * @return the first code point in its iteration range - * @stable + * @stable ICU 2.0 */ virtual UChar32 first32(void); @@ -163,7 +163,7 @@ public: * to the second code point. This is an alternative to setToStart() * for forward iteration with next32PostInc(). * @return the first code point in its iteration range. - * @stable + * @stable ICU 2.0 */ virtual UChar32 first32PostInc(void); @@ -172,7 +172,7 @@ public: * iteration range, and returns that code unit. * This can be used to begin an iteration with previous(). * @return the last code unit in its iteration range. - * @stable + * @stable ICU 2.0 */ virtual UChar last(void); @@ -181,7 +181,7 @@ public: * iteration range, and returns that code unit. * This can be used to begin an iteration with previous32(). * @return the last code point in its iteration range. - * @stable + * @stable ICU 2.0 */ virtual UChar32 last32(void); @@ -191,7 +191,7 @@ public: * returns that code unit. * @position the position within the text-storage object * @return the code unit - * @stable + * @stable ICU 2.0 */ virtual UChar setIndex(int32_t position); @@ -204,21 +204,21 @@ public: * (its first code unit). * @position the position within the text-storage object * @return the code unit - * @stable + * @stable ICU 2.0 */ virtual UChar32 setIndex32(int32_t position); /** * Returns the code unit the iterator currently refers to. * @return the code unit the iterator currently refers to. - * @stable + * @stable ICU 2.0 */ virtual UChar current(void) const; /** * Returns the code point the iterator currently refers to. * @return the code point the iterator currently refers to. - * @stable + * @stable ICU 2.0 */ virtual UChar32 current32(void) const; @@ -227,7 +227,7 @@ public: * endIndex()), and returns that code unit. If there are no more * code units to return, returns DONE. * @return the next code unit in the iteration range. - * @stable + * @stable ICU 2.0 */ virtual UChar next(void); @@ -237,7 +237,7 @@ public: * (toward endIndex()). If there are * no more code units to return, returns DONE. * @return the current code unit. - * @stable + * @stable ICU 2.0 */ virtual UChar nextPostInc(void); @@ -249,7 +249,7 @@ public: * efficient than iteration with "post-increment" semantics * that is provided by next32PostInc(). * @return the next code point in the iteration range. - * @stable + * @stable ICU 2.0 */ virtual UChar32 next32(void); @@ -259,7 +259,7 @@ public: * (toward endIndex()). If there are * no more code points to return, returns DONE. * @return the current point. - * @stable + * @stable ICU 2.0 */ virtual UChar32 next32PostInc(void); @@ -270,7 +270,7 @@ public: * iteration. * @return FALSE if there are no more code units or code points * at or after the current position in the iteration range. - * @stable + * @stable ICU 2.0 */ virtual UBool hasNext(); @@ -279,7 +279,7 @@ public: * startIndex()), and returns that code unit. If there are no more * code units to return, returns DONE. * @return the previous code unit in the iteration range. - * @stable + * @stable ICU 2.0 */ virtual UChar previous(void); @@ -288,7 +288,7 @@ public: * startIndex()), and returns that code point. If there are no more * code points to return, returns DONE. * @return the previous code point in the iteration range. - * @stable + * @stable ICU 2.0 */ virtual UChar32 previous32(void); @@ -299,7 +299,7 @@ public: * iteration. * @return FALSE if there are no more code units or code points * before the current position in the iteration range. - * @stable + * @stable ICU 2.0 */ virtual UBool hasPrevious(); @@ -312,7 +312,7 @@ public: * a negative delta means backward. * @origin Origin enumeration {kStart, kCurrent, kEnd} * @return the new position - * @stable + * @stable ICU 2.0 */ virtual int32_t move(int32_t delta, EOrigin origin); @@ -325,13 +325,13 @@ public: * a negative delta means backward. * @origin Origin enumeration {kStart, kCurrent, kEnd} * @return the new position - * @stable + * @stable ICU 2.0 */ virtual int32_t move32(int32_t delta, EOrigin origin); /** * Sets the iterator to iterate over a new range of text - * @stable + * @stable ICU 2.0 */ void setText(const UChar* newText, int32_t newTextLength); @@ -340,14 +340,14 @@ public: * referred to by "result". Even if this iterator iterates across * only a part of this string, the whole string is copied. * @param result Receives a copy of the text under iteration. - * @stable + * @stable ICU 2.0 */ virtual void getText(UnicodeString& result); /** * Return a class ID for this object (not really public) * @return a class ID for this object. - * @stable + * @stable ICU 2.0 */ virtual UClassID getDynamicClassID(void) const { return getStaticClassID(); } @@ -355,7 +355,7 @@ public: /** * Return a class ID for this class (not really public) * @return a class ID for this class - * @stable + * @stable ICU 2.0 */ static UClassID getStaticClassID(void) { return (UClassID)(&fgClassID); } diff --git a/icu4c/source/common/unicode/uclean.h b/icu4c/source/common/unicode/uclean.h index 35ae7760038..ace9ff25ce1 100644 --- a/icu4c/source/common/unicode/uclean.h +++ b/icu4c/source/common/unicode/uclean.h @@ -52,7 +52,7 @@ * Use this function with great care! *

* - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 u_cleanup(void); diff --git a/icu4c/source/common/unicode/ucnv.h b/icu4c/source/common/unicode/ucnv.h index 7957bda3c7e..b9bb76aa5fe 100644 --- a/icu4c/source/common/unicode/ucnv.h +++ b/icu4c/source/common/unicode/ucnv.h @@ -66,7 +66,7 @@ U_CDECL_BEGIN /** * Enum for specifying basic types of converters * @see ucnv_getType - * @stable + * @stable ICU 2.0 */ typedef enum { UCNV_UNSUPPORTED_CONVERTER = -1, @@ -118,7 +118,7 @@ typedef enum { * @see ucnv_getPlatform * @see ucnv_openCCSID * @see ucnv_getCCSID - * @stable + * @stable ICU 2.0 */ typedef enum { UCNV_UNKNOWN = -1, @@ -135,7 +135,7 @@ typedef enum { * @param reason Defines the reason the callback was invoked * @see ucnv_setToUCallBack * @see UConverterToUnicodeArgs - * @stable + * @stable ICU 2.0 */ typedef void (U_EXPORT2 *UConverterToUCallback) ( const void* context, @@ -155,7 +155,7 @@ typedef void (U_EXPORT2 *UConverterToUCallback) ( * @param codePoint Single UChar32 (UTF-32) containing the concerend Unicode codepoint. * @param reason Defines the reason the callback was invoked * @see ucnv_setFromUCallBack - * @stable + * @stable ICU 2.0 */ typedef void (U_EXPORT2 *UConverterFromUCallback) ( const void* context, @@ -171,28 +171,28 @@ U_CDECL_END /** * Character that separates converter names from options and options from each other. * @see ucnv_open - * @stable + * @stable ICU 2.0 */ #define UCNV_OPTION_SEP_CHAR ',' /** * String version of UCNV_OPTION_SEP_CHAR. * @see ucnv_open - * @stable + * @stable ICU 2.0 */ #define UCNV_OPTION_SEP_STRING "," /** * Character that separates a converter option from its value. * @see ucnv_open - * @stable + * @stable ICU 2.0 */ #define UCNV_VALUE_SEP_CHAR '=' /** * String version of UCNV_VALUE_SEP_CHAR. * @see ucnv_open - * @stable + * @stable ICU 2.0 */ #define UCNV_VALUE_SEP_STRING "=" @@ -202,7 +202,7 @@ U_CDECL_END * See convrtrs.txt. * * @see ucnv_open - * @stable + * @stable ICU 2.0 */ #define UCNV_LOCALE_OPTION_STRING ",locale=" @@ -239,7 +239,7 @@ U_CDECL_END * @return 0 if the names match, or a negative value if the name1 * lexically precedes name2, or a positive value if the name1 * lexically follows name2. - * @stable + * @stable ICU 2.0 */ U_CAPI int U_EXPORT2 ucnv_compareNames(const char *name1, const char *name2); @@ -272,7 +272,7 @@ ucnv_compareNames(const char *name1, const char *name2); * @see ucnv_openU * @see ucnv_openCCSID * @see ucnv_close - * @stable + * @stable ICU 2.0 */ U_CAPI UConverter* U_EXPORT2 ucnv_open (const char *converterName, UErrorCode * err); @@ -299,7 +299,7 @@ ucnv_open (const char *converterName, UErrorCode * err); * @see ucnv_openCCSID * @see ucnv_close * @see ucnv_getDefaultName - * @stable + * @stable ICU 2.0 */ U_CAPI UConverter* U_EXPORT2 ucnv_openU (const UChar * name, @@ -367,7 +367,7 @@ ucnv_openU (const UChar * name, * @see ucnv_getCCSID * @see ucnv_getPlatform * @see UConverterPlatform - * @stable + * @stable ICU 2.0 */ U_CAPI UConverter* U_EXPORT2 ucnv_openCCSID (int32_t codepage, @@ -418,7 +418,7 @@ ucnv_openPackage (const char *packageName, const char *converterName, UErrorCo * @param status to indicate whether the operation went on smoothly or there were errors * An informational status value, U_SAFECLONE_ALLOCATED_ERROR, is used if any allocations were necessary. * @return pointer to the new clone - * @stable + * @stable ICU 2.0 */ U_CAPI UConverter * U_EXPORT2 ucnv_safeClone(const UConverter *cnv, @@ -438,7 +438,7 @@ ucnv_safeClone(const UConverter *cnv, * @see ucnv_open * @see ucnv_openU * @see ucnv_openCCSID - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_close (UConverter * converter); @@ -455,7 +455,7 @@ ucnv_close (UConverter * converter); * If the substitution character array is too small, an * U_INDEX_OUTOFBOUNDS_ERROR will be returned. * @see ucnv_setSubstChars - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_getSubstChars (const UConverter * converter, @@ -473,7 +473,7 @@ ucnv_getSubstChars (const UConverter * converter, * @param err the error status code. U_INDEX_OUTOFBOUNDS_ERROR if * len is bigger than the maximum number of bytes allowed in subchars * @see ucnv_getSubstChars - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_setSubstChars (UConverter * converter, @@ -492,7 +492,7 @@ ucnv_setSubstChars (UConverter * converter, * @param err the error status code. * If the substitution character array is too small, an * U_INDEX_OUTOFBOUNDS_ERROR will be returned. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_getInvalidChars (const UConverter * converter, @@ -511,7 +511,7 @@ ucnv_getInvalidChars (const UConverter * converter, * @param err the error status code. * If the substitution character array is too small, an * U_INDEX_OUTOFBOUNDS_ERROR will be returned. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_getInvalidUChars (const UConverter * converter, @@ -524,7 +524,7 @@ ucnv_getInvalidUChars (const UConverter * converter, * in the case of an error, to restart a conversion from a known default state. * It will also empty the internal output buffers. * @param converter the Unicode converter - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_reset (UConverter * converter); @@ -535,7 +535,7 @@ ucnv_reset (UConverter * converter); * Unicode to a known default state. It will also empty the internal * output buffers used for the conversion to Unicode codepoints. * @param converter the Unicode converter - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_resetToUnicode(UConverter *converter); @@ -546,7 +546,7 @@ ucnv_resetToUnicode(UConverter *converter); * Unicode to a known default state. It will also empty the internal output * buffers used for the conversion from Unicode codepoints. * @param converter the Unicode converter - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_resetFromUnicode(UConverter *converter); @@ -557,7 +557,7 @@ ucnv_resetFromUnicode(UConverter *converter); * @param converter the Unicode converter * @return the maximum number of bytes allowed by this particular converter * @see ucnv_getMinCharSize - * @stable + * @stable ICU 2.0 */ U_CAPI int8_t U_EXPORT2 ucnv_getMaxCharSize (const UConverter * converter); @@ -569,7 +569,7 @@ ucnv_getMaxCharSize (const UConverter * converter); * @param converter the Unicode converter * @return the minimum number of bytes allowed by this particular converter * @see ucnv_getMaxCharSize - * @stable + * @stable ICU 2.0 */ U_CAPI int8_t U_EXPORT2 ucnv_getMinCharSize (const UConverter * converter); @@ -586,7 +586,7 @@ ucnv_getMinCharSize (const UConverter * converter); * @param err error status code * @return displayNameLength number of UChar needed in displayName * @see ucnv_getName - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucnv_getDisplayName (const UConverter * converter, @@ -603,7 +603,7 @@ ucnv_getDisplayName (const UConverter * converter, * @param err UErrorCode status * @return the internal name of the converter * @see ucnv_getDisplayName - * @stable + * @stable ICU 2.0 */ U_CAPI const char * U_EXPORT2 ucnv_getName (const UConverter * converter, UErrorCode * err); @@ -630,7 +630,7 @@ ucnv_getName (const UConverter * converter, UErrorCode * err); * will be returned * @see ucnv_openCCSID * @see ucnv_getPlatform - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucnv_getCCSID (const UConverter * converter, @@ -644,7 +644,7 @@ ucnv_getCCSID (const UConverter * converter, * @param converter the Unicode converter * @param err the error status code. * @return The codepage platform - * @stable + * @stable ICU 2.0 */ U_CAPI UConverterPlatform U_EXPORT2 ucnv_getPlatform (const UConverter * converter, @@ -656,7 +656,7 @@ ucnv_getPlatform (const UConverter * converter, * EBCDIC_STATEFUL, LATIN_1 * @param converter a valid, opened converter * @return the type of the converter - * @stable + * @stable ICU 2.0 */ U_CAPI UConverterType U_EXPORT2 ucnv_getType (const UConverter * converter); @@ -674,7 +674,7 @@ ucnv_getType (const UConverter * converter); * @param err error status, U_ILLEGAL_ARGUMENT_ERROR if the * converter is not a type which can return starters. * @see ucnv_getType - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_getStarters(const UConverter* converter, UBool starters[256], @@ -690,7 +690,7 @@ U_CAPI void U_EXPORT2 ucnv_getStarters(const UConverter* converter, * @param action fillin: returns the callback function pointer * @param context fillin: returns the callback's private void* context * @see ucnv_setToUCallBack - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_getToUCallBack (const UConverter * converter, @@ -706,7 +706,7 @@ ucnv_getToUCallBack (const UConverter * converter, * @param action fillin: returns the callback function pointer * @param context fillin: returns the callback's private void* context * @see ucnv_setFromUCallBack - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_getFromUCallBack (const UConverter * converter, @@ -725,7 +725,7 @@ ucnv_getFromUCallBack (const UConverter * converter, * @param oldContext fillin: returns the old callback's private void* context * @param err The error code status * @see ucnv_getToUCallBack - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_setToUCallBack (UConverter * converter, @@ -747,7 +747,7 @@ ucnv_setToUCallBack (UConverter * converter, * @param oldContext fillin: returns the old callback's private void* context * @param err The error code status * @see ucnv_getFromUCallBack - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_setFromUCallBack (UConverter * converter, @@ -807,7 +807,7 @@ ucnv_setFromUCallBack (UConverter * converter, * @see ucnv_convert * @see ucnv_getMinCharSize * @see ucnv_setToUCallBack - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_fromUnicode (UConverter * converter, @@ -870,7 +870,7 @@ ucnv_fromUnicode (UConverter * converter, * @see ucnv_getMinCharSize * @see ucnv_setFromUCallBack * @see ucnv_getNextUChar - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_toUnicode (UConverter * converter, @@ -940,7 +940,7 @@ ucnv_fromUChars(UConverter *cnv, * and a buffer of the indicated length would need to be passed in * @see ucnv_toUnicode * @see ucnv_convert - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucnv_toUChars(UConverter *cnv, @@ -988,7 +988,7 @@ ucnv_toUChars(UConverter *cnv, * @see ucnv_toUnicode * @see ucnv_toUChars * @see ucnv_convert - * @stable + * @stable ICU 2.0 */ U_CAPI UChar32 U_EXPORT2 ucnv_getNextUChar (UConverter * converter, @@ -1017,7 +1017,7 @@ ucnv_getNextUChar (UConverter * converter, * @see ucnv_fromUChars * @see ucnv_toUChars * @see ucnv_getNextUChar - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucnv_convert (const char *toConverterName, @@ -1033,7 +1033,7 @@ ucnv_convert (const char *toConverterName, * * @return the number of cached converters successfully deleted * @see ucnv_close - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucnv_flushCache (void); @@ -1044,7 +1044,7 @@ ucnv_flushCache (void); * * @return the number of available converters * @see ucnv_getAvailableName - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ucnv_countAvailable (void); @@ -1055,7 +1055,7 @@ ucnv_countAvailable (void); * @param n the index to a converter available on the system (in the range [0..ucnv_countAvaiable()]) * @return a pointer a string (library owned), or NULL if the index is out of bounds. * @see ucnv_countAvailable - * @stable + * @stable ICU 2.0 */ U_CAPI const char* U_EXPORT2 ucnv_getAvailableName (int32_t n); @@ -1082,7 +1082,7 @@ ucnv_openAllNames(UErrorCode *pErrorCode); * @param alias alias name * @param pErrorCode error status * @return number of names on alias list for given alias - * @stable + * @stable ICU 2.0 */ U_CAPI uint16_t U_EXPORT2 ucnv_countAliases(const char *alias, UErrorCode *pErrorCode); @@ -1097,7 +1097,7 @@ ucnv_countAliases(const char *alias, UErrorCode *pErrorCode); * @param pErrorCode result of operation * @return returns the name of the alias at given index * @see ucnv_countAliases - * @stable + * @stable ICU 2.0 */ U_CAPI const char * U_EXPORT2 ucnv_getAlias(const char *alias, uint16_t n, UErrorCode *pErrorCode); @@ -1113,7 +1113,7 @@ ucnv_getAlias(const char *alias, uint16_t n, UErrorCode *pErrorCode); * (const char *) that will be filled in. * The strings themselves are owned by the library. * @param pErrorCode result of operation - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_getAliases(const char *alias, const char **aliases, UErrorCode *pErrorCode); @@ -1150,7 +1150,7 @@ ucnv_openStandardNames(const char *convName, /** * Gives the number of standards associated to converter names. * @return number of standards - * @stable + * @stable ICU 2.0 */ U_CAPI uint16_t U_EXPORT2 ucnv_countStandards(void); @@ -1160,7 +1160,7 @@ ucnv_countStandards(void); * @param n index in standard list * @param pErrorCode result of operation * @return returns the name of the standard at given index. Owned by the library. - * @stable + * @stable ICU 2.0 */ U_CAPI const char * U_EXPORT2 ucnv_getStandard(uint16_t n, UErrorCode *pErrorCode); @@ -1174,7 +1174,7 @@ ucnv_getStandard(uint16_t n, UErrorCode *pErrorCode); * @return returns the standard converter name; * if a standard converter name cannot be determined, * then NULL is returned. Owned by the library. - * @stable + * @stable ICU 2.0 */ U_CAPI const char * U_EXPORT2 ucnv_getStandardName(const char *name, const char *standard, UErrorCode *pErrorCode); @@ -1201,7 +1201,7 @@ ucnv_getCanonicalName(const char *alias, const char *standard, UErrorCode *pErro * then NULL is returned. * Storage owned by the library * @see ucnv_setDefaultName - * @stable + * @stable ICU 2.0 */ U_CAPI const char * U_EXPORT2 ucnv_getDefaultName (void); @@ -1212,7 +1212,7 @@ ucnv_getDefaultName (void); * @param name the converter name to be the default (must exist). * @see ucnv_getDefaultName * @system SYSTEM API - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_setDefaultName (const char *name); @@ -1232,7 +1232,7 @@ ucnv_setDefaultName (const char *name); * @param source the input buffer to be fixed * @param sourceLen the length of the input buffer * @see ucnv_isAmbiguous - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_fixFileSeparator(const UConverter *cnv, UChar* source, int32_t sourceLen); @@ -1243,7 +1243,7 @@ ucnv_fixFileSeparator(const UConverter *cnv, UChar* source, int32_t sourceLen); * @param cnv the converter to be tested * @return TRUE if the converter contains ambiguous mapping of the same * character, FALSE otherwise. - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 ucnv_isAmbiguous(const UConverter *cnv); @@ -1253,7 +1253,7 @@ ucnv_isAmbiguous(const UConverter *cnv); * @param cnv The converter to set the fallback mapping usage on. * @param usesFallback TRUE if the user wants the converter to take advantage of the fallback * mapping, FALSE otherwise. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_setFallback(UConverter *cnv, UBool usesFallback); @@ -1262,7 +1262,7 @@ ucnv_setFallback(UConverter *cnv, UBool usesFallback); * Determines if the converter uses fallback mappings or not. * @param cnv The converter to be tested * @return TRUE if the converter uses fallback, FALSE otherwise. - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 ucnv_usesFallback(const UConverter *cnv); diff --git a/icu4c/source/common/unicode/ucnv_cb.h b/icu4c/source/common/unicode/ucnv_cb.h index 31e0f144c33..315cab3d6bf 100644 --- a/icu4c/source/common/unicode/ucnv_cb.h +++ b/icu4c/source/common/unicode/ucnv_cb.h @@ -77,7 +77,7 @@ * be returned to the user, because it means that not all data could be written into the target buffer, and some is * in the converter error buffer. * @see ucnv_cbFromUWriteSub - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_cbFromUWriteBytes (UConverterFromUnicodeArgs *args, @@ -97,7 +97,7 @@ ucnv_cbFromUWriteBytes (UConverterFromUnicodeArgs *args, * be returned to the user, because it means that not all data could be written into the target buffer, and some is * in the converter error buffer. * @see ucnv_cbFromUWriteBytes - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_cbFromUWriteSub (UConverterFromUnicodeArgs *args, @@ -114,7 +114,7 @@ ucnv_cbFromUWriteSub (UConverterFromUnicodeArgs *args, * @param offsetIndex the relative offset index from callback which will be set * @param err error status U_BUFFER_OVERFLOW * @see ucnv_cbToUWriteSub - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_cbFromUWriteUChars(UConverterFromUnicodeArgs *args, const UChar** source, @@ -133,7 +133,7 @@ U_CAPI void U_EXPORT2 ucnv_cbFromUWriteUChars(UConverterFromUnicodeArgs *args, * @param offsetIndex the relative offset index which will be written. * @param err error status U_BUFFER_OVERFLOW * @see ucnv_cbToUWriteSub - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_cbToUWriteUChars (UConverterToUnicodeArgs *args, const UChar* source, @@ -149,7 +149,7 @@ U_CAPI void U_EXPORT2 ucnv_cbToUWriteUChars (UConverterToUnicodeArgs *args, * @param offsetIndex the relative offset index from callback. * @param err error status U_BUFFER_OVERFLOW * @see ucnv_cbToUWriteUChars - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ucnv_cbToUWriteSub (UConverterToUnicodeArgs *args, int32_t offsetIndex, diff --git a/icu4c/source/common/unicode/ucnv_err.h b/icu4c/source/common/unicode/ucnv_err.h index 874b0b5d0de..336c4b009e2 100644 --- a/icu4c/source/common/unicode/ucnv_err.h +++ b/icu4c/source/common/unicode/ucnv_err.h @@ -63,14 +63,14 @@ /** * FROM_U, TO_U options for sub and skip callbacks - * @stable + * @stable ICU 2.0 */ #define UCNV_SUB_STOP_ON_ILLEGAL "i" #define UCNV_SKIP_STOP_ON_ILLEGAL "i" /** * FROM_U_CALLBACK_ESCAPE options - * @stable + * @stable ICU 2.0 */ #define UCNV_ESCAPE_ICU NULL #define UCNV_ESCAPE_JAVA "J" @@ -83,7 +83,7 @@ * The process condition code to be used with the callbacks. * Codes which are greater than UCNV_IRREGULAR should be * passed on to any chained callbacks. - * @stable + * @stable ICU 2.0 */ typedef enum { UCNV_UNASSIGNED = 0, /**< The code point is unassigned. @@ -120,7 +120,7 @@ typedef enum { /** * The structure for the fromUnicode callback function parameter. - * @stable + * @stable ICU 2.0 */ typedef struct { uint16_t size; @@ -136,7 +136,7 @@ typedef struct { /** * The structure for the toUnicode callback function parameter. - * @stable + * @stable ICU 2.0 */ typedef struct { uint16_t size; @@ -154,7 +154,7 @@ typedef struct { * DO NOT CALL THIS FUNCTION DIRECTLY! * This From Unicode callback STOPS at the ILLEGAL_SEQUENCE, * returning the error code back to the caller immediately. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 UCNV_FROM_U_CALLBACK_STOP ( const void *context, @@ -172,7 +172,7 @@ U_CAPI void U_EXPORT2 UCNV_FROM_U_CALLBACK_STOP ( * This To Unicode callback STOPS at the ILLEGAL_SEQUENCE, * returning the error code back to the caller immediately. * - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 UCNV_TO_U_CALLBACK_STOP ( const void *context, @@ -192,7 +192,7 @@ U_CAPI void U_EXPORT2 UCNV_TO_U_CALLBACK_STOP ( * returning the error code back to the caller immediately. * NULL: Skips any ILLEGAL_SEQUENCE * - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 UCNV_FROM_U_CALLBACK_SKIP ( const void *context, @@ -214,7 +214,7 @@ U_CAPI void U_EXPORT2 UCNV_FROM_U_CALLBACK_SKIP ( * returning the error code back to the caller immediately. * NULL: Substitutes any ILLEGAL_SEQUENCE * @see ucnv_setSubstChars - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 UCNV_FROM_U_CALLBACK_SUBSTITUTE ( @@ -263,7 +263,7 @@ U_CAPI void U_EXPORT2 UCNV_FROM_U_CALLBACK_SUBSTITUTE ( * it will substitute the illegal sequence with the substitution characters. * Note that codeUnit(32bit int eg: unit of a surrogate pair) is represented as * 𣑖 - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 UCNV_FROM_U_CALLBACK_ESCAPE ( @@ -286,7 +286,7 @@ U_CAPI void U_EXPORT2 UCNV_FROM_U_CALLBACK_ESCAPE ( * returning the error code back to the caller immediately. * NULL: Skips any ILLEGAL_SEQUENCE * - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 UCNV_TO_U_CALLBACK_SKIP ( const void *context, @@ -305,7 +305,7 @@ U_CAPI void U_EXPORT2 UCNV_TO_U_CALLBACK_SKIP ( * UCNV_SUB_STOP_ON_ILLEGAL: STOPS at the ILLEGAL_SEQUENCE, * returning the error code back to the caller immediately. * NULL: Substitutes any ILLEGAL_SEQUENCE - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 UCNV_TO_U_CALLBACK_SUBSTITUTE ( const void *context, @@ -320,7 +320,7 @@ U_CAPI void U_EXPORT2 UCNV_TO_U_CALLBACK_SUBSTITUTE ( * This To Unicode callback will Substitute the ILLEGAL SEQUENCE with the * hexadecimal representation of the illegal bytes * (in the format %XNN, e.g. "%XFF%X0A%XC8%X03"). - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 UCNV_TO_U_CALLBACK_ESCAPE ( diff --git a/icu4c/source/common/unicode/udata.h b/icu4c/source/common/unicode/udata.h index d2de25656ac..b9a54d05ec5 100644 --- a/icu4c/source/common/unicode/udata.h +++ b/icu4c/source/common/unicode/udata.h @@ -66,7 +66,7 @@ U_CDECL_BEGIN * common place to store the source version of the data; * for data from the Unicode character database, this could * reflect the Unicode version.

- * @stable + * @stable ICU 2.0 */ typedef struct { /** @memo sizeof(UDataInfo) */ @@ -100,7 +100,7 @@ typedef struct { /** * Forward declaration of the data memory type. - * @stable + * @stable ICU 2.0 */ typedef struct UDataMemory UDataMemory; @@ -115,7 +115,7 @@ typedef struct UDataMemory UDataMemory; * by udata_openChoice() if this function * returns TRUE. * @return TRUE if the current data memory is acceptable - * @stable + * @stable ICU 2.0 */ typedef UBool U_CALLCONV UDataMemoryIsAcceptable(void *context, @@ -140,7 +140,7 @@ UDataMemoryIsAcceptable(void *context, * @return A pointer (handle) to a data memory object, or NULL * if an error occurs. Call udata_getMemory() * to get a pointer to the actual data. - * @stable + * @stable ICU 2.0 */ U_CAPI UDataMemory * U_EXPORT2 udata_open(const char *path, const char *type, const char *name, @@ -202,7 +202,7 @@ udata_open(const char *path, const char *type, const char *name, * @return A pointer (handle) to a data memory object, or NULL * if an error occurs. Call udata_getMemory() * to get a pointer to the actual data. - * @stable + * @stable ICU 2.0 */ U_CAPI UDataMemory * U_EXPORT2 udata_openChoice(const char *path, const char *type, const char *name, @@ -214,7 +214,7 @@ udata_openChoice(const char *path, const char *type, const char *name, * This function must be called to allow the system to * release resources associated with this data memory. * @param pData The pointer to data memory object - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 udata_close(UDataMemory *pData); @@ -223,7 +223,7 @@ udata_close(UDataMemory *pData); * Get the pointer to the actual data inside the data memory. * The data is read-only. * @param pData The pointer to data memory object - * @stable + * @stable ICU 2.0 */ U_CAPI const void * U_EXPORT2 udata_getMemory(UDataMemory *pData); @@ -244,7 +244,7 @@ udata_getMemory(UDataMemory *pData); * in the data memory object. If this structure is smaller than * pInfo->size, then the size will be * adjusted and only part of the structure will be filled. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 udata_getInfo(UDataMemory *pData, UDataInfo *pInfo); @@ -278,7 +278,7 @@ udata_getInfo(UDataMemory *pData, UDataInfo *pInfo); * * @param data pointer to ICU common data * @param err outgoing error status U_USING_DEFAULT_ERROR, U_UNSUPPORTED_ERROR - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 @@ -305,7 +305,7 @@ udata_setCommonData(const void *data, UErrorCode *err); * to (open) this data. * @param data pointer to the data * @param err outgoing error status U_USING_DEFAULT_ERROR, U_UNSUPPORTED_ERROR - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 udata_setAppData(const char *path, const void *data, UErrorCode *err); diff --git a/icu4c/source/common/unicode/uloc.h b/icu4c/source/common/unicode/uloc.h index cfb960690fc..e8518ddefbc 100644 --- a/icu4c/source/common/unicode/uloc.h +++ b/icu4c/source/common/unicode/uloc.h @@ -196,7 +196,7 @@ /* * Useful constants for language. - * @stable + * @stable ICU 2.0 */ #define ULOC_CHINESE "zh" #define ULOC_ENGLISH "en" @@ -210,7 +210,7 @@ /* * Useful constants for country/region. - * @stable + * @stable ICU 2.0 */ #define ULOC_CANADA "en_CA" #define ULOC_CANADA_FRENCH "fr_CA" @@ -228,19 +228,19 @@ /** * Useful constant for the maximum size of the language part of a locale ID. * (including the terminating NULL). - * @stable + * @stable ICU 2.0 */ #define ULOC_LANG_CAPACITY 12 /** * Useful constant for the maximum size of the country part of a locale ID * (including the terminating NULL). - * @stable + * @stable ICU 2.0 */ #define ULOC_COUNTRY_CAPACITY 4 /** * Useful constant for the maximum size of the whole locale ID * (including the terminating NULL). - * @stable + * @stable ICU 2.0 */ #define ULOC_FULLNAME_CAPACITY 50 @@ -277,7 +277,7 @@ typedef enum { * * @return the ICU default locale * @system - * @stable + * @stable ICU 2.0 */ U_CAPI const char* U_EXPORT2 uloc_getDefault(void); @@ -289,7 +289,7 @@ uloc_getDefault(void); * the system's default locale. * @param status the error information if the setting of default locale fails * @system - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 uloc_setDefault(const char* localeID, @@ -305,7 +305,7 @@ uloc_setDefault(const char* localeID, * @param err error information if retrieving the language code failed * @return the actual buffer size needed for the langauge code. If it's greater * than languageCapacity, the returned language code will be truncated. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 uloc_getLanguage(const char* localeID, @@ -323,7 +323,7 @@ uloc_getLanguage(const char* localeID, * @param err error information if retrieving the country code failed * @return the actual buffer size needed for the country code. If it's greater * than countryCapacity, the returned country code will be truncated. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 uloc_getCountry(const char* localeID, @@ -341,7 +341,7 @@ uloc_getCountry(const char* localeID, * @param err error information if retrieving the variant code failed * @return the actual buffer size needed for the variant code. If it's greater * than variantCapacity, the returned variant code will be truncated. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 uloc_getVariant(const char* localeID, @@ -363,7 +363,7 @@ uloc_getVariant(const char* localeID, * @param err error information if retrieving the full name failed * @return the actual buffer size needed for the full name. If it's greater * than nameCapacity, the returned full name will be truncated. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 uloc_getName(const char* localeID, @@ -376,7 +376,7 @@ uloc_getName(const char* localeID, * * @param localeID the locale to get the ISO langauge code with * @return language the ISO langauge code for localeID - * @stable + * @stable ICU 2.0 */ U_CAPI const char* U_EXPORT2 uloc_getISO3Language(const char* localeID); @@ -387,7 +387,7 @@ uloc_getISO3Language(const char* localeID); * * @param localeID the locale to get the ISO country code with * @return country the ISO country code for localeID - * @stable + * @stable ICU 2.0 */ U_CAPI const char* U_EXPORT2 uloc_getISO3Country(const char* localeID); @@ -397,7 +397,7 @@ uloc_getISO3Country(const char* localeID); * * @param localeID the locale to get the Win32 LCID value with * @return country the Win32 LCID for localeID - * @stable + * @stable ICU 2.0 */ U_CAPI uint32_t U_EXPORT2 uloc_getLCID(const char* localeID); @@ -416,7 +416,7 @@ uloc_getLCID(const char* localeID); * @param status error information if retrieving the displayable language code failed * @return the actual buffer size needed for the displayable langauge code. If it's greater * than languageCapacity, the returned language code will be truncated. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 uloc_getDisplayLanguage(const char* locale, @@ -439,7 +439,7 @@ uloc_getDisplayLanguage(const char* locale, * @param status error information if retrieving the displayable country code failed * @return the actual buffer size needed for the displayable country code. If it's greater * than countryCapacity, the returned displayable country code will be truncated. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 uloc_getDisplayCountry(const char* locale, @@ -463,7 +463,7 @@ uloc_getDisplayCountry(const char* locale, * @param status error information if retrieving the displayable variant code failed * @return the actual buffer size needed for the displayable variant code. If it's greater * than variantCapacity, the returned displayable variant code will be truncated. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 uloc_getDisplayVariant(const char* locale, @@ -486,7 +486,7 @@ uloc_getDisplayVariant(const char* locale, * @param err error information if retrieving the displayable name failed * @return the actual buffer size needed for the displayable name. If it's greater * than variantCapacity, the returned displayable name will be truncated. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 uloc_getDisplayName(const char* localeID, @@ -504,7 +504,7 @@ uloc_getDisplayName(const char* localeID, * by the caller. The locale name is terminated by a null pointer. * @param n the specific locale name index of the available locale list * @return a specified locale name of all available locales - * @stable + * @stable ICU 2.0 */ U_CAPI const char* U_EXPORT2 uloc_getAvailable(int32_t n); @@ -513,7 +513,7 @@ uloc_getAvailable(int32_t n); * Gets the size of the all available locale list. * * @return the size of the locale list - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 uloc_countAvailable(void); @@ -524,7 +524,7 @@ U_CAPI int32_t U_EXPORT2 uloc_countAvailable(void); * by ICU-- do not delete them, and do not write through them. The array is * terminated with a null pointer. * @return a list of all available language codes - * @stable + * @stable ICU 2.0 */ U_CAPI const char* const* U_EXPORT2 uloc_getISOLanguages(void); @@ -536,7 +536,7 @@ uloc_getISOLanguages(void); * owned by ICU-- do not delete them, and do not write through them. The array is * terminated with a null pointer. * @return a list of all available country codes - * @stable + * @stable ICU 2.0 */ U_CAPI const char* const* U_EXPORT2 uloc_getISOCountries(void); @@ -552,7 +552,7 @@ uloc_getISOCountries(void); * @param parentCapacity Size of the output buffer. * @param err A UErrorCode value. * @return The length of the parent locale ID. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 uloc_getParent(const char* localeID, diff --git a/icu4c/source/common/unicode/umisc.h b/icu4c/source/common/unicode/umisc.h index dbafff94d16..3ed3860e930 100644 --- a/icu4c/source/common/unicode/umisc.h +++ b/icu4c/source/common/unicode/umisc.h @@ -25,7 +25,7 @@ */ /** A struct representing a range of text containing a specific field - * @stable + * @stable ICU 2.0 */ typedef struct UFieldPosition { /** The field */ diff --git a/icu4c/source/common/unicode/unifilt.h b/icu4c/source/common/unicode/unifilt.h index 418f17576fc..9d20a469946 100644 --- a/icu4c/source/common/unicode/unifilt.h +++ b/icu4c/source/common/unicode/unifilt.h @@ -45,14 +45,14 @@ U_NAMESPACE_BEGIN * UnicodeMatcher protocol. * * @see UnicodeFilterLogic - * @stable + * @stable ICU 2.0 */ class U_COMMON_API UnicodeFilter : public UnicodeFunctor, public UnicodeMatcher { public: /** * Destructor - * @stable + * @stable ICU 2.0 */ virtual ~UnicodeFilter(); @@ -61,7 +61,7 @@ public: * subset. In other words, if a character is to be * filtered, then contains() returns * false. - * @stable + * @stable ICU 2.0 */ virtual UBool contains(UChar32 c) const = 0; diff --git a/icu4c/source/common/unicode/unifunct.h b/icu4c/source/common/unicode/unifunct.h index 40c6d74753b..c3fb041bbd3 100644 --- a/icu4c/source/common/unicode/unifunct.h +++ b/icu4c/source/common/unicode/unifunct.h @@ -71,7 +71,7 @@ class U_COMMON_API UnicodeFunctor : public UObject { * . Derived::getStaticClassID()) ... * * @return The class ID for all objects of this class. - * @stable + * @stable ICU 2.0 */ static UClassID getStaticClassID(void) { return (UClassID)&fgClassID; } diff --git a/icu4c/source/common/unicode/uniset.h b/icu4c/source/common/unicode/uniset.h index 4d92e53ba21..bde1088a2ae 100644 --- a/icu4c/source/common/unicode/uniset.h +++ b/icu4c/source/common/unicode/uniset.h @@ -254,7 +254,7 @@ class UVector; * * * @author Alan Liu - * @stable + * @stable ICU 2.0 */ class U_COMMON_API UnicodeSet : public UnicodeFilter { @@ -297,7 +297,7 @@ public: /** * Constructs an empty set. - * @stable + * @stable ICU 2.0 */ UnicodeSet(); @@ -316,7 +316,7 @@ public: * @param pattern a string specifying what characters are in the set * @exception IllegalArgumentException if the pattern * contains a syntax error. - * @stable + * @stable ICU 2.0 */ UnicodeSet(const UnicodeString& pattern, UErrorCode& status); @@ -331,19 +331,19 @@ public: /** * Constructs a set that is identical to the given UnicodeSet. - * @stable + * @stable ICU 2.0 */ UnicodeSet(const UnicodeSet& o); /** * Destructs the set. - * @stable + * @stable ICU 2.0 */ virtual ~UnicodeSet(); /** * Assigns this object to be a copy of another. - * @stable + * @stable ICU 2.0 */ UnicodeSet& operator=(const UnicodeSet& o); @@ -356,14 +356,14 @@ public: * * @param o set to be compared for equality with this set. * @return true if the specified set is equal to this set. - * @stable + * @stable ICU 2.0 */ virtual UBool operator==(const UnicodeSet& o) const; /** * Compares the specified object with this set for equality. Returns * true if the specified set is not equal to this set. - * @stable + * @stable ICU 2.0 */ UBool operator!=(const UnicodeSet& o) const; @@ -371,7 +371,7 @@ public: * Returns a copy of this object. All UnicodeFunctor objects have * to support cloning in order to allow classes using * UnicodeFunctors, such as Transliterator, to implement cloning. - * @stable + * @stable ICU 2.0 */ virtual UnicodeFunctor* clone() const; @@ -380,7 +380,7 @@ public: * * @return the hash code value for this set. * @see Object#hashCode() - * @stable + * @stable ICU 2.0 */ virtual int32_t hashCode(void) const; @@ -412,7 +412,7 @@ public: * @param pattern a string specifying what characters are in the set * @exception IllegalArgumentException if the pattern * contains a syntax error. - * @stable + * @stable ICU 2.0 */ virtual UnicodeSet& applyPattern(const UnicodeString& pattern, UErrorCode& status); @@ -427,7 +427,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& toPattern(UnicodeString& result, UBool escapeUnprintable = FALSE) const; @@ -493,7 +493,7 @@ public: * n, where 0 <= n <= 65536. * * @return the number of elements in this set (its cardinality). - * @stable + * @stable ICU 2.0 */ virtual int32_t size(void) const; @@ -501,7 +501,7 @@ public: * Returns true if this set contains no elements. * * @return true if this set contains no elements. - * @stable + * @stable ICU 2.0 */ virtual UBool isEmpty(void) const; @@ -509,7 +509,7 @@ public: * Returns true if this set contains the given character. * @param c character to be checked for containment * @return true if the test condition is met - * @stable + * @stable ICU 2.0 */ virtual UBool contains(UChar32 c) const; @@ -519,7 +519,7 @@ public: * @param start first character, inclusive, of the range * @param end last character, inclusive, of the range * @return true if the test condition is met - * @stable + * @stable ICU 2.0 */ virtual UBool contains(UChar32 start, UChar32 end) const; @@ -682,7 +682,7 @@ public: * to this set. * @param end last character, inclusive, of range to be added * to this set. - * @stable + * @stable ICU 2.0 */ virtual UnicodeSet& add(UChar32 start, UChar32 end); @@ -690,7 +690,7 @@ public: * Adds the specified character to this set if it is not already * present. If this set already contains the specified character, * the call leaves this set unchanged. - * @stable + * @stable ICU 2.0 */ UnicodeSet& add(UChar32 c); @@ -776,14 +776,14 @@ public: * to this set. * @param end last character, inclusive, of range to be retained * to this set. - * @stable + * @stable ICU 2.0 */ virtual UnicodeSet& retain(UChar32 start, UChar32 end); /** * Retain the specified character from this set if it is present. - * @stable + * @stable ICU 2.0 */ UnicodeSet& retain(UChar32 c); @@ -797,7 +797,7 @@ public: * from this set. * @param end last character, inclusive, of range to be removed * from this set. - * @stable + * @stable ICU 2.0 */ virtual UnicodeSet& remove(UChar32 start, UChar32 end); @@ -805,7 +805,7 @@ public: * Removes the specified character from this set if it is present. * The set will not contain the specified range once the call * returns. - * @stable + * @stable ICU 2.0 */ UnicodeSet& remove(UChar32 c); @@ -822,7 +822,7 @@ public: * Inverts this set. This operation modifies this set so that * its value is its complement. This is equivalent to * complement(MIN_VALUE, MAX_VALUE). - * @stable + * @stable ICU 2.0 */ virtual UnicodeSet& complement(void); @@ -837,7 +837,7 @@ public: * from this set. * @param end last character, inclusive, of range to be removed * from this set. - * @stable + * @stable ICU 2.0 */ virtual UnicodeSet& complement(UChar32 start, UChar32 end); @@ -845,7 +845,7 @@ public: * Complements the specified character in this set. The character * will be removed if it is in this set, or will be added if it is * not in this set. - * @stable + * @stable ICU 2.0 */ UnicodeSet& complement(UChar32 c); @@ -868,7 +868,7 @@ public: * * @param c set whose elements are to be added to this set. * @see #add(char, char) - * @stable + * @stable ICU 2.0 */ virtual UnicodeSet& addAll(const UnicodeSet& c); @@ -880,7 +880,7 @@ public: * the intersection of the two sets. * * @param c set that defines which elements this set will retain. - * @stable + * @stable ICU 2.0 */ virtual UnicodeSet& retainAll(const UnicodeSet& c); @@ -892,7 +892,7 @@ public: * * @param c set that defines which elements will be removed from * this set. - * @stable + * @stable ICU 2.0 */ virtual UnicodeSet& removeAll(const UnicodeSet& c); @@ -909,7 +909,7 @@ public: /** * Removes all of the elements from this set. This set will be * empty after this call returns. - * @stable + * @stable ICU 2.0 */ virtual UnicodeSet& clear(void); @@ -1001,7 +1001,7 @@ public: * . Derived::getStaticClassID()) ... * * @return The class ID for all objects of this class. - * @stable + * @stable ICU 2.0 */ static UClassID getStaticClassID(void) { return (UClassID)&fgClassID; } diff --git a/icu4c/source/common/unicode/unistr.h b/icu4c/source/common/unicode/unistr.h index 33238d04192..cfde3d3b238 100644 --- a/icu4c/source/common/unicode/unistr.h +++ b/icu4c/source/common/unicode/unistr.h @@ -72,7 +72,7 @@ class UnicodeConverter; // unicode/convert.h * NUL, must be specified as a constant. * The U_STRING_DECL macro should be invoked exactly once for one * such string variable before it is used. - * @stable + * @stable ICU 2.0 */ #if U_SIZEOF_WCHAR_T==U_SIZEOF_UCHAR && U_CHARSET_FAMILY==U_ASCII_FAMILY # define UNICODE_STRING(cs, length) UnicodeString(TRUE, (const UChar *)L ## cs, length) @@ -93,7 +93,7 @@ class UnicodeConverter; // unicode/convert.h * See utypes.h for details. * * The string parameter must be a C string literal. - * @stable + * @stable ICU 2.0 */ #if U_SIZEOF_WCHAR_T==U_SIZEOF_UCHAR && U_CHARSET_FAMILY==U_ASCII_FAMILY # define UNICODE_STRING_SIMPLE(cs) UnicodeString(TRUE, (const UChar *)L ## cs, -1) @@ -140,7 +140,7 @@ class UnicodeConverter; // unicode/convert.h * * @see utf.h * @see CharacterIterator - * @stable + * @stable ICU 2.0 */ class U_COMMON_API UnicodeString : public Replaceable { @@ -157,7 +157,7 @@ public: * @param text The UnicodeString to compare to this one. * @return TRUE if text contains the same characters as this one, * FALSE otherwise. - * @stable + * @stable ICU 2.0 */ inline UBool operator== (const UnicodeString& text) const; @@ -166,7 +166,7 @@ public: * @param text The UnicodeString to compare to this one. * @return FALSE if text contains the same characters as this one, * TRUE otherwise. - * @stable + * @stable ICU 2.0 */ inline UBool operator!= (const UnicodeString& text) const; @@ -175,7 +175,7 @@ public: * @param text The UnicodeString to compare to this one. * @return TRUE if the characters in text are bitwise * greater than the characters in this, FALSE otherwise - * @stable + * @stable ICU 2.0 */ inline UBool operator> (const UnicodeString& text) const; @@ -184,7 +184,7 @@ public: * @param text The UnicodeString to compare to this one. * @return TRUE if the characters in text are bitwise * less than the characters in this, FALSE otherwise - * @stable + * @stable ICU 2.0 */ inline UBool operator< (const UnicodeString& text) const; @@ -193,7 +193,7 @@ public: * @param text The UnicodeString to compare to this one. * @return TRUE if the characters in text are bitwise * greater than or equal to the characters in this, FALSE otherwise - * @stable + * @stable ICU 2.0 */ inline UBool operator>= (const UnicodeString& text) const; @@ -202,7 +202,7 @@ public: * @param text The UnicodeString to compare to this one. * @return TRUE if the characters in text are bitwise * less than or equal to the characters in this, FALSE otherwise - * @stable + * @stable ICU 2.0 */ inline UBool operator<= (const UnicodeString& text) const; @@ -215,7 +215,7 @@ public: * text are bitwise less than the characters in this, +1 if the * characters in text are bitwise greater than the characters * in this. - * @stable + * @stable ICU 2.0 */ inline int8_t compare(const UnicodeString& text) const; @@ -231,7 +231,7 @@ public: * text are bitwise less than the characters in this, +1 if the * characters in text are bitwise greater than the characters * in this. - * @stable + * @stable ICU 2.0 */ inline int8_t compare(int32_t start, int32_t length, @@ -252,7 +252,7 @@ public: * text are bitwise less than the characters in this, +1 if the * characters in text are bitwise greater than the characters * in this. - * @stable + * @stable ICU 2.0 */ inline int8_t compare(int32_t start, int32_t length, @@ -270,7 +270,7 @@ public: * text are bitwise less than the characters in this, +1 if the * characters in text are bitwise greater than the characters * in this. - * @stable + * @stable ICU 2.0 */ inline int8_t compare(const UChar *srcChars, int32_t srcLength) const; @@ -287,7 +287,7 @@ public: * text are bitwise less than the characters in this, +1 if the * characters in text are bitwise greater than the characters * in this. - * @stable + * @stable ICU 2.0 */ inline int8_t compare(int32_t start, int32_t length, @@ -308,7 +308,7 @@ public: * text are bitwise less than the characters in this, +1 if the * characters in text are bitwise greater than the characters * in this. - * @stable + * @stable ICU 2.0 */ inline int8_t compare(int32_t start, int32_t length, @@ -331,7 +331,7 @@ public: * text are bitwise less than the characters in this, +1 if the * characters in text are bitwise greater than the characters * in this. - * @stable + * @stable ICU 2.0 */ inline int8_t compareBetween(int32_t start, int32_t limit, @@ -354,7 +354,7 @@ public: * @return a negative/zero/positive integer corresponding to whether * this string is less than/equal to/greater than the second one * in code point order - * @stable + * @stable ICU 2.0 */ inline int8_t compareCodePointOrder(const UnicodeString& text) const; @@ -375,7 +375,7 @@ public: * @return a negative/zero/positive integer corresponding to whether * this string is less than/equal to/greater than the second one * in code point order - * @stable + * @stable ICU 2.0 */ inline int8_t compareCodePointOrder(int32_t start, int32_t length, @@ -400,7 +400,7 @@ public: * @return a negative/zero/positive integer corresponding to whether * this string is less than/equal to/greater than the second one * in code point order - * @stable + * @stable ICU 2.0 */ inline int8_t compareCodePointOrder(int32_t start, int32_t length, @@ -424,7 +424,7 @@ public: * @return a negative/zero/positive integer corresponding to whether * this string is less than/equal to/greater than the second one * in code point order - * @stable + * @stable ICU 2.0 */ inline int8_t compareCodePointOrder(const UChar *srcChars, int32_t srcLength) const; @@ -446,7 +446,7 @@ public: * @return a negative/zero/positive integer corresponding to whether * this string is less than/equal to/greater than the second one * in code point order - * @stable + * @stable ICU 2.0 */ inline int8_t compareCodePointOrder(int32_t start, int32_t length, @@ -471,7 +471,7 @@ public: * @return a negative/zero/positive integer corresponding to whether * this string is less than/equal to/greater than the second one * in code point order - * @stable + * @stable ICU 2.0 */ inline int8_t compareCodePointOrder(int32_t start, int32_t length, @@ -498,7 +498,7 @@ public: * @return a negative/zero/positive integer corresponding to whether * this string is less than/equal to/greater than the second one * in code point order - * @stable + * @stable ICU 2.0 */ inline int8_t compareCodePointOrderBetween(int32_t start, int32_t limit, @@ -522,7 +522,7 @@ public: * - U_FOLD_CASE_EXCLUDE_SPECIAL_I * * @return A negative, zero, or positive integer indicating the comparison result. - * @stable + * @stable ICU 2.0 */ inline int8_t caseCompare(const UnicodeString& text, uint32_t options) const; @@ -544,7 +544,7 @@ public: * - U_FOLD_CASE_EXCLUDE_SPECIAL_I * * @return A negative, zero, or positive integer indicating the comparison result. - * @stable + * @stable ICU 2.0 */ inline int8_t caseCompare(int32_t start, int32_t length, @@ -571,7 +571,7 @@ public: * - U_FOLD_CASE_EXCLUDE_SPECIAL_I * * @return A negative, zero, or positive integer indicating the comparison result. - * @stable + * @stable ICU 2.0 */ inline int8_t caseCompare(int32_t start, int32_t length, @@ -597,7 +597,7 @@ public: * - U_FOLD_CASE_EXCLUDE_SPECIAL_I * * @return A negative, zero, or positive integer indicating the comparison result. - * @stable + * @stable ICU 2.0 */ inline int8_t caseCompare(const UChar *srcChars, int32_t srcLength, @@ -621,7 +621,7 @@ public: * - U_FOLD_CASE_EXCLUDE_SPECIAL_I * * @return A negative, zero, or positive integer indicating the comparison result. - * @stable + * @stable ICU 2.0 */ inline int8_t caseCompare(int32_t start, int32_t length, @@ -648,7 +648,7 @@ public: * - U_FOLD_CASE_EXCLUDE_SPECIAL_I * * @return A negative, zero, or positive integer indicating the comparison result. - * @stable + * @stable ICU 2.0 */ inline int8_t caseCompare(int32_t start, int32_t length, @@ -677,7 +677,7 @@ public: * - U_FOLD_CASE_EXCLUDE_SPECIAL_I * * @return A negative, zero, or positive integer indicating the comparison result. - * @stable + * @stable ICU 2.0 */ inline int8_t caseCompareBetween(int32_t start, int32_t limit, @@ -691,7 +691,7 @@ public: * @param text The text to match. * @return TRUE if this starts with the characters in text, * FALSE otherwise - * @stable + * @stable ICU 2.0 */ inline UBool startsWith(const UnicodeString& text) const; @@ -703,7 +703,7 @@ public: * @param srcLength the number of characters in srcText to match * @return TRUE if this starts with the characters in text, * FALSE otherwise - * @stable + * @stable ICU 2.0 */ inline UBool startsWith(const UnicodeString& srcText, int32_t srcStart, @@ -715,7 +715,7 @@ public: * @param srcLength the number of characters in srcChars * @return TRUE if this starts with the characters in srcChars, * FALSE otherwise - * @stable + * @stable ICU 2.0 */ inline UBool startsWith(const UChar *srcChars, int32_t srcLength) const; @@ -727,7 +727,7 @@ public: * @param srcStart the offset into srcText to start matching * @param srcLength the number of characters in srcChars to match * @return TRUE if this ends with the characters in srcChars, FALSE otherwise - * @stable + * @stable ICU 2.0 */ inline UBool startsWith(const UChar *srcChars, int32_t srcStart, @@ -738,7 +738,7 @@ public: * @param text The text to match. * @return TRUE if this ends with the characters in text, * FALSE otherwise - * @stable + * @stable ICU 2.0 */ inline UBool endsWith(const UnicodeString& text) const; @@ -750,7 +750,7 @@ public: * @param srcLength the number of characters in srcText to match * @return TRUE if this ends with the characters in text, * FALSE otherwise - * @stable + * @stable ICU 2.0 */ inline UBool endsWith(const UnicodeString& srcText, int32_t srcStart, @@ -762,7 +762,7 @@ public: * @param srcLength the number of characters in srcChars * @return TRUE if this ends with the characters in srcChars, * FALSE otherwise - * @stable + * @stable ICU 2.0 */ inline UBool endsWith(const UChar *srcChars, int32_t srcLength) const; @@ -775,7 +775,7 @@ public: * @param srcLength the number of characters in srcChars to match * @return TRUE if this ends with the characters in srcChars, * FALSE otherwise - * @stable + * @stable ICU 2.0 */ inline UBool endsWith(const UChar *srcChars, int32_t srcStart, @@ -790,7 +790,7 @@ public: * @param text The text to search for. * @return The offset into this of the start of text, * or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t indexOf(const UnicodeString& text) const; @@ -801,7 +801,7 @@ public: * @param start The offset at which searching will start. * @return The offset into this of the start of text, * or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t indexOf(const UnicodeString& text, int32_t start) const; @@ -815,7 +815,7 @@ public: * @param length The number of characters to search * @return The offset into this of the start of text, * or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t indexOf(const UnicodeString& text, int32_t start, @@ -835,7 +835,7 @@ public: * @param length the number of characters in this to search * @return The offset into this of the start of text, * or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t indexOf(const UnicodeString& srcText, int32_t srcStart, @@ -852,7 +852,7 @@ public: * @param start the offset into this at which to start matching * @return The offset into this of the start of text, * or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t indexOf(const UChar *srcChars, int32_t srcLength, @@ -868,7 +868,7 @@ public: * @param length The number of characters to search * @return The offset into this of the start of srcChars, * or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t indexOf(const UChar *srcChars, int32_t srcLength, @@ -889,7 +889,7 @@ public: * @param length the number of characters in this to search * @return The offset into this of the start of text, * or -1 if not found. - * @stable + * @stable ICU 2.0 */ int32_t indexOf(const UChar *srcChars, int32_t srcStart, @@ -902,7 +902,7 @@ public: * using bitwise comparison. * @param c The code unit to search for. * @return The offset into this of c, or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t indexOf(UChar c) const; @@ -912,7 +912,7 @@ public: * * @param c The code point to search for. * @return The offset into this of c, or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t indexOf(UChar32 c) const; @@ -922,7 +922,7 @@ public: * @param c The code unit to search for. * @param start The offset at which searching will start. * @return The offset into this of c, or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t indexOf(UChar c, int32_t start) const; @@ -934,7 +934,7 @@ public: * @param c The code point to search for. * @param start The offset at which searching will start. * @return The offset into this of c, or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t indexOf(UChar32 c, int32_t start) const; @@ -947,7 +947,7 @@ public: * @param start the offset into this at which to start matching * @param length the number of characters in this to search * @return The offset into this of c, or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t indexOf(UChar c, int32_t start, @@ -962,7 +962,7 @@ public: * @param start the offset into this at which to start matching * @param length the number of characters in this to search * @return The offset into this of c, or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t indexOf(UChar32 c, int32_t start, @@ -974,7 +974,7 @@ public: * @param text The text to search for. * @return The offset into this of the start of text, * or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t lastIndexOf(const UnicodeString& text) const; @@ -985,7 +985,7 @@ public: * @param start The offset at which searching will start. * @return The offset into this of the start of text, * or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t lastIndexOf(const UnicodeString& text, int32_t start) const; @@ -999,7 +999,7 @@ public: * @param length The number of characters to search * @return The offset into this of the start of text, * or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t lastIndexOf(const UnicodeString& text, int32_t start, @@ -1019,7 +1019,7 @@ public: * @param length the number of characters in this to search * @return The offset into this of the start of text, * or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t lastIndexOf(const UnicodeString& srcText, int32_t srcStart, @@ -1035,7 +1035,7 @@ public: * @param start the offset into this at which to start matching * @return The offset into this of the start of text, * or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t lastIndexOf(const UChar *srcChars, int32_t srcLength, @@ -1051,7 +1051,7 @@ public: * @param length The number of characters to search * @return The offset into this of the start of srcChars, * or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t lastIndexOf(const UChar *srcChars, int32_t srcLength, @@ -1072,7 +1072,7 @@ public: * @param length the number of characters in this to search * @return The offset into this of the start of text, * or -1 if not found. - * @stable + * @stable ICU 2.0 */ int32_t lastIndexOf(const UChar *srcChars, int32_t srcStart, @@ -1085,7 +1085,7 @@ public: * using bitwise comparison. * @param c The code unit to search for. * @return The offset into this of c, or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t lastIndexOf(UChar c) const; @@ -1095,7 +1095,7 @@ public: * * @param c The code point to search for. * @return The offset into this of c, or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t lastIndexOf(UChar32 c) const; @@ -1105,7 +1105,7 @@ public: * @param c The code unit to search for. * @param start The offset at which searching will start. * @return The offset into this of c, or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t lastIndexOf(UChar c, int32_t start) const; @@ -1117,7 +1117,7 @@ public: * @param c The code point to search for. * @param start The offset at which searching will start. * @return The offset into this of c, or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t lastIndexOf(UChar32 c, int32_t start) const; @@ -1130,7 +1130,7 @@ public: * @param start the offset into this at which to start matching * @param length the number of characters in this to search * @return The offset into this of c, or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t lastIndexOf(UChar c, int32_t start, @@ -1145,7 +1145,7 @@ public: * @param start the offset into this at which to start matching * @param length the number of characters in this to search * @return The offset into this of c, or -1 if not found. - * @stable + * @stable ICU 2.0 */ inline int32_t lastIndexOf(UChar32 c, int32_t start, @@ -1160,7 +1160,7 @@ public: * @param offset a valid offset into the text * @return the code unit at offset offset * or 0xffff if the offset is not valid for this string - * @stable + * @stable ICU 2.0 */ inline UChar charAt(int32_t offset) const; @@ -1169,7 +1169,7 @@ public: * If the offset is not valid (0..length()-1) then U+ffff is returned. * @param offset a valid offset into the text * @return the code unit at offset offset - * @stable + * @stable ICU 2.0 */ inline UChar operator[] (int32_t offset) const; @@ -1182,7 +1182,7 @@ public: * that will be assembled into a code point (21-bit value) and returned * @return the code point of text at offset * or 0xffff if the offset is not valid for this string - * @stable + * @stable ICU 2.0 */ inline UChar32 char32At(int32_t offset) const; @@ -1199,7 +1199,7 @@ public: * @param offset a valid offset into one code point of the text * @return offset of the first code unit of the same code point * @see U16_SET_CP_START - * @stable + * @stable ICU 2.0 */ inline int32_t getChar32Start(int32_t offset) const; @@ -1217,7 +1217,7 @@ public: * @param offset a valid offset after any code unit of a code point of the text * @return offset of the first code unit after the same code point * @see U16_SET_CP_LIMIT - * @stable + * @stable ICU 2.0 */ inline int32_t getChar32Limit(int32_t offset) const; @@ -1329,7 +1329,7 @@ public: * @param delta (signed) code point count to move the index forward or backward * in the string * @return the resulting code unit index - * @stable + * @stable ICU 2.0 */ int32_t moveIndex32(int32_t index, int32_t delta) const; @@ -1348,7 +1348,7 @@ public: * must be at least (dstStart + length). * @param dstStart the offset in dst where the first character * will be extracted - * @stable + * @stable ICU 2.0 */ inline void extract(int32_t start, int32_t length, @@ -1374,7 +1374,7 @@ public: * @param destCapacity Number of UChars available at dest. * @param errorCode ICU error code. * @return length() - * @stable + * @stable ICU 2.0 */ int32_t extract(UChar *dest, int32_t destCapacity, @@ -1388,7 +1388,7 @@ public: * @param length the number of characters to extract * @param target UnicodeString into which to copy characters. * @return A reference to target - * @stable + * @stable ICU 2.0 */ inline void extract(int32_t start, int32_t length, @@ -1403,7 +1403,7 @@ public: * must be at least (dstStart + (limit - start)). * @param dstStart the offset in dst where the first character * will be extracted - * @stable + * @stable ICU 2.0 */ inline void extractBetween(int32_t start, int32_t limit, @@ -1417,7 +1417,7 @@ public: * @param limit offset immediately following the last character to be copied * @param target UnicodeString into which to copy characters. * @return A reference to target - * @stable + * @stable ICU 2.0 */ virtual void extractBetween(int32_t start, int32_t limit, @@ -1441,7 +1441,7 @@ public: * target is returned. It is assumed that the target is big enough * to fit all of the characters. * @return the output string length, not including the terminating NUL - * @stable + * @stable ICU 2.0 */ inline int32_t extract(int32_t start, int32_t startLength, @@ -1470,7 +1470,7 @@ public: * If target is NULL, then the number of bytes required for * target is returned. * @return the output string length, not including the terminating NUL - * @stable + * @stable ICU 2.0 */ int32_t extract(int32_t start, int32_t startLength, @@ -1493,7 +1493,7 @@ public: * @return the length of the output string, not counting the terminating NUL; * if the length is greater than destCapacity, then the string will not fit * and a buffer of the indicated length would need to be passed in - * @stable + * @stable ICU 2.0 */ int32_t extract(char *dest, int32_t destCapacity, UConverter *cnv, @@ -1505,7 +1505,7 @@ public: * Return the length of the UnicodeString object. * The length is the number of characters in the text. * @return the length of the UnicodeString object - * @stable + * @stable ICU 2.0 */ inline int32_t length(void) const; @@ -1519,7 +1519,7 @@ public: * @param start the index of the first code unit to check * @param length the number of UChar code units to check * @return the number of code points in the specified code units - * @stable + * @stable ICU 2.0 */ int32_t countChar32(int32_t start=0, int32_t length=INT32_MAX) const; @@ -1553,7 +1553,7 @@ public: /** * Determine if this string is empty. * @return TRUE if this string contains 0 characters, FALSE otherwise. - * @stable + * @stable ICU 2.0 */ inline UBool isEmpty(void) const; @@ -1564,7 +1564,7 @@ public: * * @return the number of UChars available in the internal buffer * @see getBuffer - * @stable + * @stable ICU 2.0 */ inline int32_t getCapacity(void) const; @@ -1573,7 +1573,7 @@ public: /** * Generate a hash code for this object. * @return The hash code of this UnicodeString. - * @stable + * @stable ICU 2.0 */ inline int32_t hashCode(void) const; @@ -1586,7 +1586,7 @@ public: * * @return TRUE if the string is valid, FALSE otherwise * @see setToBogus() - * @stable + * @stable ICU 2.0 */ inline UBool isBogus(void) const; @@ -1602,7 +1602,7 @@ public: * with the characters from srcText. * @param srcText The text containing the characters to replace * @return a reference to this - * @stable + * @stable ICU 2.0 */ UnicodeString &operator=(const UnicodeString &srcText); @@ -1633,7 +1633,7 @@ public: * with the code unit ch. * @param ch the code unit to replace * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& operator= (UChar ch); @@ -1642,7 +1642,7 @@ public: * with the code point ch. * @param ch the code point to replace * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& operator= (UChar32 ch); @@ -1671,7 +1671,7 @@ public: * @param srcLength the number of characters in srcText in the * replace string. * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& setTo(const UnicodeString& srcText, int32_t srcStart, @@ -1683,7 +1683,7 @@ public: * srcText is not modified. * @param srcText the source for the new characters * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& setTo(const UnicodeString& srcText); @@ -1693,7 +1693,7 @@ public: * @param srcChars the source for the new characters * @param srcLength the number of Unicode characters in srcChars. * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& setTo(const UChar *srcChars, int32_t srcLength); @@ -1704,7 +1704,7 @@ public: * @param srcChar the code unit which becomes the UnicodeString's character * content * @return a reference to this - * @stable + * @stable ICU 2.0 */ UnicodeString& setTo(UChar srcChar); @@ -1714,7 +1714,7 @@ public: * @param srcChar the code point which becomes the UnicodeString's character * content * @return a reference to this - * @stable + * @stable ICU 2.0 */ UnicodeString& setTo(UChar32 srcChar); @@ -1736,7 +1736,7 @@ public: * If -1, then this constructor will determine the length * by calling u_strlen(). * @return a reference to this - * @stable + * @stable ICU 2.0 */ UnicodeString &setTo(UBool isTerminated, const UChar *text, @@ -1759,7 +1759,7 @@ public: * @param buffLength The number of Unicode characters in buffer to alias. * @param buffCapacity The size of buffer in UChars. * @return a reference to this - * @stable + * @stable ICU 2.0 */ UnicodeString &setTo(UChar *buffer, int32_t buffLength, @@ -1803,7 +1803,7 @@ public: * \endcode * * @see isBogus() - * @stable + * @stable ICU 2.0 */ void setToBogus(); @@ -1812,7 +1812,7 @@ public: * @param offset A valid offset into the text of the character to set * @param ch The new character * @return A reference to this - * @stable + * @stable ICU 2.0 */ UnicodeString& setCharAt(int32_t offset, UChar ch); @@ -1825,7 +1825,7 @@ public: * object. * @param ch the code unit to be appended * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& operator+= (UChar ch); @@ -1834,7 +1834,7 @@ public: * object. * @param ch the code point to be appended * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& operator+= (UChar32 ch); @@ -1844,7 +1844,7 @@ public: * not modified. * @param srcText the source for the new characters * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& operator+= (const UnicodeString& srcText); @@ -1860,7 +1860,7 @@ public: * @param srcLength the number of characters in srcText in * the append string * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& append(const UnicodeString& srcText, int32_t srcStart, @@ -1871,7 +1871,7 @@ public: * offset start. srcText is not modified. * @param srcText the source for the new characters * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& append(const UnicodeString& srcText); @@ -1886,7 +1886,7 @@ public: * @param srcLength the number of characters in srcChars in * the append string * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& append(const UChar *srcChars, int32_t srcStart, @@ -1898,7 +1898,7 @@ public: * @param srcChars the source for the new characters * @param srcLength the number of Unicode characters in srcChars * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& append(const UChar *srcChars, int32_t srcLength); @@ -1907,7 +1907,7 @@ public: * Append the code unit srcChar to the UnicodeString object. * @param srcChar the code unit to append * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& append(UChar srcChar); @@ -1915,7 +1915,7 @@ public: * Append the code point srcChar to the UnicodeString object. * @param srcChar the code point to append * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& append(UChar32 srcChar); @@ -1933,7 +1933,7 @@ public: * @param srcLength the number of characters in srcText in * the insert string * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& insert(int32_t start, const UnicodeString& srcText, @@ -1946,7 +1946,7 @@ public: * @param start the offset where the insertion begins * @param srcText the source for the new characters * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& insert(int32_t start, const UnicodeString& srcText); @@ -1962,7 +1962,7 @@ public: * @param srcLength the number of characters in srcChars * in the insert string * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& insert(int32_t start, const UChar *srcChars, @@ -1976,7 +1976,7 @@ public: * @param srcChars the source for the new characters * @param srcLength the number of Unicode characters in srcChars. * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& insert(int32_t start, const UChar *srcChars, @@ -1988,7 +1988,7 @@ public: * @param start the offset at which the insertion occurs * @param srcChar the code unit to insert * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& insert(int32_t start, UChar srcChar); @@ -1999,7 +1999,7 @@ public: * @param start the offset at which the insertion occurs * @param srcChar the code point to insert * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& insert(int32_t start, UChar32 srcChar); @@ -2022,7 +2022,7 @@ public: * @param srcLength the number of characters in srcText in * the replace string * @return a reference to this - * @stable + * @stable ICU 2.0 */ UnicodeString& replace(int32_t start, int32_t length, @@ -2040,7 +2040,7 @@ public: * start + length is not modified. * @param srcText the source for the new characters * @return a reference to this - * @stable + * @stable ICU 2.0 */ UnicodeString& replace(int32_t start, int32_t length, @@ -2061,7 +2061,7 @@ public: * @param srcLength the number of characters in srcChars * in the replace string * @return a reference to this - * @stable + * @stable ICU 2.0 */ UnicodeString& replace(int32_t start, int32_t length, @@ -2079,7 +2079,7 @@ public: * @param srcChars the source for the new characters * @param srcLength the number of Unicode characters in srcChars * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& replace(int32_t start, int32_t length, @@ -2095,7 +2095,7 @@ public: * start + length is not modified. * @param srcChar the new code unit * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& replace(int32_t start, int32_t length, @@ -2110,7 +2110,7 @@ public: * start + length is not modified. * @param srcChar the new code point * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& replace(int32_t start, int32_t length, @@ -2123,7 +2123,7 @@ public: * @param limit the offset immediately following the replace range * @param srcText the source for the new characters * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& replaceBetween(int32_t start, int32_t limit, @@ -2141,7 +2141,7 @@ public: * @param srcLimit the offset immediately following the range to copy * in srcText * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& replaceBetween(int32_t start, int32_t limit, @@ -2157,7 +2157,7 @@ public: * <= length(). * @param text the text to replace characters start * to limit - 1 - * @stable + * @stable ICU 2.0 */ virtual void handleReplaceBetween(int32_t start, int32_t limit, @@ -2182,7 +2182,7 @@ public: * start..limit-1 will be copied to dest. * Implementations of this method may assume that dest <= start || * dest >= limit. - * @stable + * @stable ICU 2.0 */ virtual void copy(int32_t start, int32_t limit, int32_t dest); @@ -2194,7 +2194,7 @@ public: * @param oldText the text containing the search text * @param newText the text containing the replacement text * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& findAndReplace(const UnicodeString& oldText, const UnicodeString& newText); @@ -2208,7 +2208,7 @@ public: * @param oldText the text containing the search text * @param newText the text containing the replacement text * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& findAndReplace(int32_t start, int32_t length, @@ -2230,7 +2230,7 @@ public: * @param newStart the start of the replacement range in newText * @param newLength the length of the replacement range in newText * @return a reference to this - * @stable + * @stable ICU 2.0 */ UnicodeString& findAndReplace(int32_t start, int32_t length, @@ -2247,7 +2247,7 @@ public: /** * Remove all characters from the UnicodeString object. * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& remove(void); @@ -2257,7 +2257,7 @@ public: * @param start the offset of the first character to remove * @param length the number of characters to remove * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& remove(int32_t start, int32_t length = (int32_t)INT32_MAX); @@ -2268,7 +2268,7 @@ public: * @param start the offset of the first character to remove * @param limit the offset immediately following the range to remove * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& removeBetween(int32_t start, int32_t limit = (int32_t)INT32_MAX); @@ -2285,7 +2285,7 @@ public: * @param padChar the character to use for padding. Defaults to * space (U+0020) * @return TRUE if the text was padded, FALSE otherwise. - * @stable + * @stable ICU 2.0 */ UBool padLeading(int32_t targetLength, UChar padChar = 0x0020); @@ -2299,7 +2299,7 @@ public: * @param padChar the character to use for padding. Defaults to * space (U+0020) * @return TRUE if the text was padded, FALSE otherwise. - * @stable + * @stable ICU 2.0 */ UBool padTrailing(int32_t targetLength, UChar padChar = 0x0020); @@ -2308,14 +2308,14 @@ public: * Truncate this UnicodeString to the targetLength. * @param targetLength the desired length of this UnicodeString. * @return TRUE if the text was truncated, FALSE otherwise - * @stable + * @stable ICU 2.0 */ inline UBool truncate(int32_t targetLength); /** * Trims leading and trailing whitespace from this UnicodeString. * @return a reference to this - * @stable + * @stable ICU 2.0 */ UnicodeString& trim(void); @@ -2325,7 +2325,7 @@ public: /** * Reverse this UnicodeString in place. * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& reverse(void); @@ -2335,7 +2335,7 @@ public: * @param start the start of the range to reverse * @param length the number of characters to to reverse * @return a reference to this - * @stable + * @stable ICU 2.0 */ inline UnicodeString& reverse(int32_t start, int32_t length); @@ -2344,7 +2344,7 @@ public: * Convert the characters in this to UPPER CASE following the conventions of * the default locale. * @return A reference to this. - * @stable + * @stable ICU 2.0 */ UnicodeString& toUpper(void); @@ -2353,7 +2353,7 @@ public: * a specific locale. * @param locale The locale containing the conventions to use. * @return A reference to this. - * @stable + * @stable ICU 2.0 */ UnicodeString& toUpper(const Locale& locale); @@ -2361,7 +2361,7 @@ public: * Convert the characters in this to lower case following the conventions of * the default locale. * @return A reference to this. - * @stable + * @stable ICU 2.0 */ UnicodeString& toLower(void); @@ -2370,7 +2370,7 @@ public: * a specific locale. * @param locale The locale containing the conventions to use. * @return A reference to this. - * @stable + * @stable ICU 2.0 */ UnicodeString& toLower(const Locale& locale); @@ -2442,7 +2442,7 @@ public: * * @param options Either U_FOLD_CASE_DEFAULT or U_FOLD_CASE_EXCLUDE_SPECIAL_I * @return A reference to this. - * @stable + * @stable ICU 2.0 */ UnicodeString &foldCase(uint32_t options=0 /*U_FOLD_CASE_DEFAULT*/); @@ -2491,7 +2491,7 @@ public: * * @see releaseBuffer * @see getTerminatedBuffer() - * @stable + * @stable ICU 2.0 */ UChar *getBuffer(int32_t minCapacity); @@ -2513,7 +2513,7 @@ public: * the current capacity of the string * * @see getBuffer(int32_t minCapacity) - * @stable + * @stable ICU 2.0 */ void releaseBuffer(int32_t newLength=-1); @@ -2545,7 +2545,7 @@ public: * * @see getBuffer(int32_t minCapacity) * @see getTerminatedBuffer() - * @stable + * @stable ICU 2.0 */ inline const UChar *getBuffer() const; @@ -2589,7 +2589,7 @@ public: //======================================== /** Construct an empty UnicodeString. - * @stable + * @stable ICU 2.0 */ UnicodeString(); @@ -2602,21 +2602,21 @@ public: * @param c is used to initially fill the string * @param count specifies how many code points c are to be written in the * string - * @stable + * @stable ICU 2.0 */ UnicodeString(int32_t capacity, UChar32 c, int32_t count); /** * Single UChar (code unit) constructor. * @param ch the character to place in the UnicodeString - * @stable + * @stable ICU 2.0 */ UnicodeString(UChar ch); /** * Single UChar32 (code point) constructor. * @param ch the character to place in the UnicodeString - * @stable + * @stable ICU 2.0 */ UnicodeString(UChar32 ch); @@ -2624,7 +2624,7 @@ public: * UChar* constructor. * @param text The characters to place in the UnicodeString. text * must be NULL (U+0000) terminated. - * @stable + * @stable ICU 2.0 */ UnicodeString(const UChar *text); @@ -2633,7 +2633,7 @@ public: * @param text The characters to place in the UnicodeString. * @param textLength The number of Unicode characters in text * to copy. - * @stable + * @stable ICU 2.0 */ UnicodeString(const UChar *text, int32_t textLength); @@ -2655,7 +2655,7 @@ public: * @param textLength The number of Unicode characters in text to alias. * If -1, then this constructor will determine the length * by calling u_strlen(). - * @stable + * @stable ICU 2.0 */ UnicodeString(UBool isTerminated, const UChar *text, @@ -2677,7 +2677,7 @@ public: * @param buffer The characters to alias for the UnicodeString. * @param buffLength The number of Unicode characters in buffer to alias. * @param buffCapacity The size of buffer in UChars. - * @stable + * @stable ICU 2.0 */ UnicodeString(UChar *buffer, int32_t buffLength, int32_t buffCapacity); @@ -2690,7 +2690,7 @@ public: * If codepage is an empty string (""), * then a simple conversion is performed on the codepage-invariant * subset ("invariant characters") of the platform encoding. See utypes.h. - * @stable + * @stable ICU 2.0 */ UnicodeString(const char *codepageData, const char *codepage = 0); @@ -2705,7 +2705,7 @@ public: * If codepage is an empty string (""), * then a simple conversion is performed on the codepage-invariant * subset ("invariant characters") of the platform encoding. See utypes.h. - * @stable + * @stable ICU 2.0 */ UnicodeString(const char *codepageData, int32_t dataLength, @@ -2730,7 +2730,7 @@ public: * @param cnv converter object (ucnv_resetToUnicode() will be called), * can be NULL for the default converter * @param errorCode normal ICU error code - * @stable + * @stable ICU 2.0 */ UnicodeString( const char *src, int32_t srcLength, @@ -2741,7 +2741,7 @@ public: /** * Copy constructor. * @param that The UnicodeString object to copy. - * @stable + * @stable ICU 2.0 */ UnicodeString(const UnicodeString& that); @@ -2763,7 +2763,7 @@ public: UnicodeString(const UnicodeString& src, int32_t srcStart, int32_t srcLength); /** Destructor. - * @stable + * @stable ICU 2.0 */ ~UnicodeString(); @@ -2844,7 +2844,7 @@ public: * @see UnicodeString#unescapeAt() * @see u_unescape() * @see u_unescapeAt() - * @stable + * @stable ICU 2.0 */ UnicodeString unescape() const; @@ -2865,7 +2865,7 @@ public: * @see UnicodeString#unescape() * @see u_unescape() * @see u_unescapeAt() - * @stable + * @stable ICU 2.0 */ UChar32 unescapeAt(int32_t &offset) const; diff --git a/icu4c/source/common/unicode/unorm.h b/icu4c/source/common/unicode/unorm.h index 0c518539a3d..822de4cf8b0 100644 --- a/icu4c/source/common/unicode/unorm.h +++ b/icu4c/source/common/unicode/unorm.h @@ -205,7 +205,7 @@ typedef enum { * @param status A pointer to a UErrorCode to receive any errors. * @return The total buffer size needed; if greater than resultLength, * the output was truncated, and the error code is set to U_BUFFER_OVERFLOW_ERROR. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 unorm_normalize(const UChar *source, int32_t sourceLength, @@ -225,7 +225,7 @@ unorm_normalize(const UChar *source, int32_t sourceLength, /** * Result values for unorm_quickCheck(). * For details see Unicode Technical Report 15. - * @stable + * @stable ICU 2.0 */ typedef enum UNormalizationCheckResult { /** @@ -261,7 +261,7 @@ typedef enum UNormalizationCheckResult { * @return UNORM_YES, UNORM_NO or UNORM_MAYBE * * @see unorm_isNormalized - * @stable + * @stable ICU 2.0 */ U_CAPI UNormalizationCheckResult U_EXPORT2 unorm_quickCheck(const UChar *source, int32_t sourcelength, diff --git a/icu4c/source/common/unicode/urep.h b/icu4c/source/common/unicode/urep.h index bcb3afd2f1a..9465b3cc410 100644 --- a/icu4c/source/common/unicode/urep.h +++ b/icu4c/source/common/unicode/urep.h @@ -33,7 +33,7 @@ U_CDECL_BEGIN * An opaque replaceable text object. This will be manipulated only * through the caller-supplied UReplaceableFunctor struct. Related * to the C++ class Replaceable. - * @stable + * @stable ICU 2.0 */ typedef void* UReplaceable; @@ -42,14 +42,14 @@ typedef void* UReplaceable; * UReplaceable. The caller should supply the required functions to * manipulate their text appropriately. Related to the C++ class * Replaceable. - * @stable + * @stable ICU 2.0 */ typedef struct UReplaceableCallbacks { /** * Function pointer that returns the number of UChar code units in * this text. - * @stable + * @stable ICU 2.0 */ int32_t (*length)(const UReplaceable* rep); @@ -58,7 +58,7 @@ typedef struct UReplaceableCallbacks { * offset into this text; 0 <= offset < n, where n is the value * returned by (*length)(rep). See unistr.h for a description of * charAt() vs. char32At(). - * @stable + * @stable ICU 2.0 */ UChar (*charAt)(const UReplaceable* rep, int32_t offset); @@ -67,7 +67,7 @@ typedef struct UReplaceableCallbacks { * Function pointer that returns a UChar32 code point at the given * offset into this text. See unistr.h for a description of * charAt() vs. char32At(). - * @stable + * @stable ICU 2.0 */ UChar32 (*char32At)(const UReplaceable* rep, int32_t offset); @@ -84,7 +84,7 @@ typedef struct UReplaceableCallbacks { * start..limit-1. * @param textLength the number of UChars at text, or -1 if text * is null-terminated. - * @stable + * @stable ICU 2.0 */ void (*replace)(UReplaceable* rep, int32_t start, @@ -120,7 +120,7 @@ typedef struct UReplaceableCallbacks { * exclusive. * @param dest the index at which the copy of the UChars should be * inserted. - * @stable + * @stable ICU 2.0 */ void (*copy)(UReplaceable* rep, int32_t start, diff --git a/icu4c/source/common/unicode/ures.h b/icu4c/source/common/unicode/ures.h index d6c146b81f1..57a2c7d8a6e 100644 --- a/icu4c/source/common/unicode/ures.h +++ b/icu4c/source/common/unicode/ures.h @@ -120,18 +120,18 @@ /** * UResourceBundle is an opaque type for handles for resource bundles in C APIs. - * @stable + * @stable ICU 2.0 */ struct UResourceBundle; /** - * @stable + * @stable ICU 2.0 */ typedef struct UResourceBundle UResourceBundle; /** * Numeric constants for types of resource items. - * @stable + * @stable ICU 2.0 */ typedef enum { RES_NONE=-1, @@ -178,7 +178,7 @@ typedef enum { * nor any of its fall back locales could be found. * @return a newly allocated resource bundle. * @see ures_close - * @stable + * @stable ICU 2.0 */ U_CAPI UResourceBundle* U_EXPORT2 ures_open(const char* path, @@ -200,7 +200,7 @@ ures_open(const char* path, * @param status fills in the outgoing error code. Either U_ZERO_ERROR or U_MISSING_RESOURCE_ERROR * @return a newly allocated resource bundle or NULL if it doesn't exist. * @see ures_close - * @stable + * @stable ICU 2.0 */ U_CAPI UResourceBundle* U_EXPORT2 ures_openDirect(const char* path, @@ -245,7 +245,7 @@ ures_openW(const wchar_t* path, * root locale will be used. * @param status : fills in the outgoing error code. * @return a newly allocated resource bundle. - * @stable + * @stable ICU 2.0 */ U_CAPI UResourceBundle* U_EXPORT2 ures_openU(const UChar* path, @@ -266,7 +266,7 @@ ures_openU(const UChar* path, * Tables: returns the number of resources in the table * single string: returns 1 *@see ures_getSize - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ures_countArrayItems(const UResourceBundle* resourceBundle, @@ -278,7 +278,7 @@ ures_countArrayItems(const UResourceBundle* resourceBundle, * * @param resourceBundle: a pointer to a resourceBundle struct. Can be NULL. * @see ures_open - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ures_close(UResourceBundle* resourceBundle); @@ -291,7 +291,7 @@ ures_close(UResourceBundle* resourceBundle); * @return A version number string as specified in the resource bundle or its parent. * The caller does not own this string. * @see ures_getVersion - * @stable + * @stable ICU 2.0 */ U_CAPI const char* U_EXPORT2 ures_getVersionNumber(const UResourceBundle* resourceBundle); @@ -303,7 +303,7 @@ ures_getVersionNumber(const UResourceBundle* resourceBundle); * @param resB The resource bundle for which the version is checked. * @param versionInfo A UVersionInfo array that is filled with the version number * as specified in the resource bundle or its parent. - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ures_getVersion(const UResourceBundle* resB, @@ -318,7 +318,7 @@ ures_getVersion(const UResourceBundle* resB, * @param resourceBundle: resource bundle in question * @param status: just for catching illegal arguments * @return A Locale name - * @stable + * @stable ICU 2.0 */ U_CAPI const char* U_EXPORT2 ures_getLocale(const UResourceBundle* resourceBundle, @@ -358,7 +358,7 @@ ures_openFillIn(UResourceBundle *r, * @see ures_getIntVector * @see ures_getInt * @see ures_getUInt - * @stable + * @stable ICU 2.0 */ U_CAPI const UChar* U_EXPORT2 ures_getString(const UResourceBundle* resourceBundle, @@ -380,7 +380,7 @@ ures_getString(const UResourceBundle* resourceBundle, * @see ures_getIntVector * @see ures_getInt * @see ures_getUInt - * @stable + * @stable ICU 2.0 */ U_CAPI const uint8_t* U_EXPORT2 ures_getBinary(const UResourceBundle* resourceBundle, @@ -402,7 +402,7 @@ ures_getBinary(const UResourceBundle* resourceBundle, * @see ures_getString * @see ures_getInt * @see ures_getUInt - * @stable + * @stable ICU 2.0 */ U_CAPI const int32_t* U_EXPORT2 ures_getIntVector(const UResourceBundle* resourceBundle, @@ -423,7 +423,7 @@ ures_getIntVector(const UResourceBundle* resourceBundle, * @see ures_getIntVector * @see ures_getBinary * @see ures_getString - * @stable + * @stable ICU 2.0 */ U_CAPI uint32_t U_EXPORT2 ures_getUInt(const UResourceBundle* resourceBundle, @@ -443,7 +443,7 @@ ures_getUInt(const UResourceBundle* resourceBundle, * @see ures_getIntVector * @see ures_getBinary * @see ures_getString - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ures_getInt(const UResourceBundle* resourceBundle, @@ -458,7 +458,7 @@ ures_getInt(const UResourceBundle* resourceBundle, * * @param resourceBundle: a resource * @return number of resources in a given resource. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 ures_getSize(UResourceBundle *resourceBundle); @@ -469,7 +469,7 @@ ures_getSize(UResourceBundle *resourceBundle); * @param resourceBundle: a resource * @return type of the given resource. * @see UResType - * @stable + * @stable ICU 2.0 */ U_CAPI UResType U_EXPORT2 ures_getType(UResourceBundle *resourceBundle); @@ -480,7 +480,7 @@ ures_getType(UResourceBundle *resourceBundle); * * @param resourceBundle: a resource * @return a key associated to this resource, or NULL if it doesn't have a key - * @stable + * @stable ICU 2.0 */ U_CAPI const char * U_EXPORT2 ures_getKey(UResourceBundle *resB); @@ -493,7 +493,7 @@ ures_getKey(UResourceBundle *resB); * Resets the internal context of a resource so that iteration starts from the first element. * * @param resourceBundle: a resource - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 ures_resetIterator(UResourceBundle *resourceBundle); @@ -503,7 +503,7 @@ ures_resetIterator(UResourceBundle *resourceBundle); * * @param resourceBundle a resource * @return TRUE if there are more elements, FALSE if there is no more elements - * @stable + * @stable ICU 2.0 */ U_CAPI UBool U_EXPORT2 ures_hasNext(UResourceBundle *resourceBundle); @@ -518,7 +518,7 @@ ures_hasNext(UResourceBundle *resourceBundle); * @param status fills in the outgoing error code. You may still get a non NULL result even if an * error occured. Check status instead. * @return a pointer to a UResourceBundle struct. If fill in param was NULL, caller must delete it - * @stable + * @stable ICU 2.0 */ U_CAPI UResourceBundle* U_EXPORT2 ures_getNextResource(UResourceBundle *resourceBundle, @@ -535,7 +535,7 @@ ures_getNextResource(UResourceBundle *resourceBundle, * @param status fills in the outgoing error code. If an error occured, we may return NULL, but don't * count on it. Check status instead! * @return a pointer to a zero-terminated UChar array which lives in a memory mapped/DLL file. - * @stable + * @stable ICU 2.0 */ U_CAPI const UChar* U_EXPORT2 ures_getNextString(UResourceBundle *resourceBundle, @@ -553,7 +553,7 @@ ures_getNextString(UResourceBundle *resourceBundle, * @param status fills in the outgoing error code. Don't count on NULL being returned if an error has * occured. Check status instead. * @return a pointer to a UResourceBundle struct. If fill in param was NULL, caller must delete it - * @stable + * @stable ICU 2.0 */ U_CAPI UResourceBundle* U_EXPORT2 ures_getByIndex(const UResourceBundle *resourceBundle, @@ -570,7 +570,7 @@ ures_getByIndex(const UResourceBundle *resourceBundle, * @param status fills in the outgoing error code. If an error occured, we may return NULL, but don't * count on it. Check status instead! * @return a pointer to a zero-terminated UChar array which lives in a memory mapped/DLL file. - * @stable + * @stable ICU 2.0 */ U_CAPI const UChar* U_EXPORT2 ures_getStringByIndex(const UResourceBundle *resB, @@ -588,7 +588,7 @@ ures_getStringByIndex(const UResourceBundle *resB, * Alternatively, you can supply a struct to be filled by this function. * @param status fills in the outgoing error code. * @return a pointer to a UResourceBundle struct. If fill in param was NULL, caller must delete it - * @stable + * @stable ICU 2.0 */ U_CAPI UResourceBundle* U_EXPORT2 ures_getByKey(const UResourceBundle *resourceBundle, @@ -606,7 +606,7 @@ ures_getByKey(const UResourceBundle *resourceBundle, * @param status fills in the outgoing error code. If an error occured, we may return NULL, but don't * count on it. Check status instead! * @return a pointer to a zero-terminated UChar array which lives in a memory mapped/DLL file. - * @stable + * @stable ICU 2.0 */ U_CAPI const UChar* U_EXPORT2 ures_getStringByKey(const UResourceBundle *resB, @@ -627,7 +627,7 @@ U_NAMESPACE_BEGIN * could be a non-failing error * e.g.: U_USING_FALLBACK_ERROR,U_USING_DEFAULT_ERROR * @return an UnicodeString object. If there is an error, string is bogus - * @stable + * @stable ICU 2.0 */ inline UnicodeString ures_getUnicodeString(const UResourceBundle *resB, @@ -646,7 +646,7 @@ ures_getUnicodeString(const UResourceBundle *resB, * @param key fill in for key associated with this string * @param status fills in the outgoing error code * @return an UnicodeString object. - * @stable + * @stable ICU 2.0 */ inline UnicodeString ures_getNextUnicodeString(UResourceBundle *resB, @@ -665,7 +665,7 @@ ures_getNextUnicodeString(UResourceBundle *resB, * @param index an index to the wanted string. * @param status fills in the outgoing error code * @return an UnicodeString object. If there is an error, string is bogus - * @stable + * @stable ICU 2.0 */ inline UnicodeString ures_getUnicodeStringByIndex(const UResourceBundle *resB, @@ -685,7 +685,7 @@ ures_getUnicodeStringByIndex(const UResourceBundle *resB, * @param key a key associated with the wanted string * @param status fills in the outgoing error code * @return an UnicodeString object. If there is an error, string is bogus - * @stable + * @stable ICU 2.0 */ inline UnicodeString ures_getUnicodeStringByKey(const UResourceBundle *resB, diff --git a/icu4c/source/common/unicode/ushape.h b/icu4c/source/common/unicode/ushape.h index ea416e3ef1d..c13d6cb05f3 100644 --- a/icu4c/source/common/unicode/ushape.h +++ b/icu4c/source/common/unicode/ushape.h @@ -94,7 +94,7 @@ * If an error occured, then no output was written, or it may be * incomplete. If U_BUFFER_OVERFLOW_ERROR is set, then * the return value indicates the necessary destination buffer size. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_shapeArabic(const UChar *source, int32_t sourceLength, @@ -104,28 +104,28 @@ u_shapeArabic(const UChar *source, int32_t sourceLength, /** * Memory option: allow the result to have a different length than the source. - * @stable + * @stable ICU 2.0 */ #define U_SHAPE_LENGTH_GROW_SHRINK 0 /** * Memory option: the result must have the same length as the source. * If more room is necessary, then try to consume spaces next to modified characters. - * @stable + * @stable ICU 2.0 */ #define U_SHAPE_LENGTH_FIXED_SPACES_NEAR 1 /** * Memory option: the result must have the same length as the source. * If more room is necessary, then try to consume spaces at the end of the text. - * @stable + * @stable ICU 2.0 */ #define U_SHAPE_LENGTH_FIXED_SPACES_AT_END 2 /** * Memory option: the result must have the same length as the source. * If more room is necessary, then try to consume spaces at the beginning of the text. - * @stable + * @stable ICU 2.0 */ #define U_SHAPE_LENGTH_FIXED_SPACES_AT_BEGINNING 3 @@ -140,7 +140,7 @@ u_shapeArabic(const UChar *source, int32_t sourceLength, * Direction indicator: * the source is in visual LTR order, * the leftmost displayed character stored first. - * @stable + * @stable ICU 2.0 */ #define U_SHAPE_TEXT_DIRECTION_VISUAL_LTR 4 @@ -162,7 +162,7 @@ u_shapeArabic(const UChar *source, int32_t sourceLength, * The only difference with U_SHAPE_LETTERS_SHAPE is that Tashkeel letters * are always "shaped" into the isolated form instead of the medial form * (selecting code points from the Arabic Presentation Forms-B block). - * @stable + * @stable ICU 2.0 */ #define U_SHAPE_LETTERS_SHAPE_TASHKEEL_ISOLATED 0x18 @@ -176,14 +176,14 @@ u_shapeArabic(const UChar *source, int32_t sourceLength, /** * Digit shaping option: * Replace European digits (U+0030...) by Arabic-Indic digits. - * @stable + * @stable ICU 2.0 */ #define U_SHAPE_DIGITS_EN2AN 0x20 /** * Digit shaping option: * Replace Arabic-Indic digits by European digits (U+0030...). - * @stable + * @stable ICU 2.0 */ #define U_SHAPE_DIGITS_AN2EN 0x40 @@ -196,7 +196,7 @@ u_shapeArabic(const UChar *source, int32_t sourceLength, * For the first characters, the preceding strongly directional character * (initial state) is assumed to be not an Arabic letter * (it is U_LEFT_TO_RIGHT [L] or U_RIGHT_TO_LEFT [R]). - * @stable + * @stable ICU 2.0 */ #define U_SHAPE_DIGITS_ALEN2AN_INIT_LR 0x60 @@ -208,7 +208,7 @@ u_shapeArabic(const UChar *source, int32_t sourceLength, * The direction of "preceding" depends on the direction indicator option. * For the first characters, the preceding strongly directional character * (initial state) is assumed to be an Arabic letter. - * @stable + * @stable ICU 2.0 */ #define U_SHAPE_DIGITS_ALEN2AN_INIT_AL 0x80 diff --git a/icu4c/source/common/unicode/ustring.h b/icu4c/source/common/unicode/ustring.h index 1b0a845efaf..7b120250b4d 100644 --- a/icu4c/source/common/unicode/ustring.h +++ b/icu4c/source/common/unicode/ustring.h @@ -72,7 +72,7 @@ * * @param s The array of UChars, NULL (U+0000) terminated. * @return The number of UChars in chars, minus the terminator. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_strlen(const UChar *s); @@ -88,7 +88,7 @@ u_strlen(const UChar *s); * @param length The number of UChar code units to be checked, or -1 to count all * code points before the first NUL (U+0000). * @return The number of code points in the specified code units. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_countChar32(const UChar *s, int32_t length); @@ -122,7 +122,7 @@ u_strHasMoreChar32Than(const UChar *s, int32_t length, int32_t number); * @param dst The destination string. * @param src The source string. * @return A pointer to dst. - * @stable + * @stable ICU 2.0 */ U_CAPI UChar* U_EXPORT2 u_strcat(UChar *dst, @@ -137,7 +137,7 @@ u_strcat(UChar *dst, * @param src The source string. * @param n The maximum number of characters to compare. * @return A pointer to dst. - * @stable + * @stable ICU 2.0 */ U_CAPI UChar* U_EXPORT2 u_strncat(UChar *dst, @@ -158,7 +158,7 @@ u_strncat(UChar *dst, * @return A pointer to the first occurrence of substring in s, * or s itself if the substring is empty, * or NULL if substring is not in s. - * @stable + * @stable ICU 2.0 * * @see u_strrstr * @see u_strFindFirst @@ -201,7 +201,7 @@ u_strFindFirst(const UChar *s, int32_t length, const UChar *substring, int32_t s * @param c The BMP code point to find. * @return A pointer to the first occurrence of c in s * or NULL if c is not in s. - * @stable + * @stable ICU 2.0 * * @see u_strchr32 * @see u_memchr @@ -221,7 +221,7 @@ u_strchr(const UChar *s, UChar c); * @param c The code point to find. * @return A pointer to the first occurrence of c in s * or NULL if c is not in s. - * @stable + * @stable ICU 2.0 * * @see u_strchr * @see u_memchr32 @@ -325,7 +325,7 @@ u_strrchr32(const UChar *s, UChar32 c); * * @return A pointer to the character in str that matches one of the * characters in accept, or NULL if no such character is found. - * @stable + * @stable ICU 2.0 */ U_CAPI UChar * U_EXPORT2 u_strpbrk(const UChar *string, const UChar *matchSet); @@ -336,7 +336,7 @@ u_strpbrk(const UChar *string, const UChar *matchSet); * Works just like C's strcspn but with Unicode. * * @see u_strspn - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_strcspn(const UChar *string, const UChar *matchSet); @@ -347,7 +347,7 @@ u_strcspn(const UChar *string, const UChar *matchSet); * Works just like C's strspn but with Unicode. * * @see u_strcspn - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_strspn(const UChar *string, const UChar *matchSet); @@ -375,7 +375,7 @@ u_strspn(const UChar *string, const UChar *matchSet); * &myLocalSaveState for this parameter). * @return A pointer to the next token found in src, or NULL * when there are no more tokens. - * @stable + * @stable ICU 2.0 */ U_CAPI UChar * U_EXPORT2 u_strtok_r(UChar *src, @@ -390,7 +390,7 @@ u_strtok_r(UChar *src, * @return 0 if s1 and s2 are bitwise equal; a negative * value if s1 is bitwise less than s2,/TT>; a positive * value if s1 is bitwise greater than s2,/TT>. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_strcmp(const UChar *s1, @@ -405,7 +405,7 @@ u_strcmp(const UChar *s1, * @return a negative/zero/positive integer corresponding to whether * the first string is less than/equal to/greater than the second one * in code point order - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_strcmpCodePointOrder(const UChar *s1, const UChar *s2); @@ -505,7 +505,7 @@ u_strCaseCompare(const UChar *s1, int32_t length1, * @return 0 if s1 and s2 are bitwise equal; a negative * value if s1 is bitwise less than s2,/TT>; a positive * value if s1 is bitwise greater than s2,/TT>. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_strncmp(const UChar *ucs1, @@ -523,7 +523,7 @@ u_strncmp(const UChar *ucs1, * @return a negative/zero/positive integer corresponding to whether * the first string is less than/equal to/greater than the second one * in code point order - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_strncmpCodePointOrder(const UChar *s1, const UChar *s2, int32_t n); @@ -545,7 +545,7 @@ u_strncmpCodePointOrder(const UChar *s1, const UChar *s2, int32_t n); * - U_FOLD_CASE_EXCLUDE_SPECIAL_I * * @return A negative, zero, or positive integer indicating the comparison result. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_strcasecmp(const UChar *s1, const UChar *s2, uint32_t options); @@ -569,7 +569,7 @@ u_strcasecmp(const UChar *s1, const UChar *s2, uint32_t options); * - U_FOLD_CASE_EXCLUDE_SPECIAL_I * * @return A negative, zero, or positive integer indicating the comparison result. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_strncasecmp(const UChar *s1, const UChar *s2, int32_t n, uint32_t options); @@ -593,7 +593,7 @@ u_strncasecmp(const UChar *s1, const UChar *s2, int32_t n, uint32_t options); * - U_FOLD_CASE_EXCLUDE_SPECIAL_I * * @return A negative, zero, or positive integer indicating the comparison result. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_memcasecmp(const UChar *s1, const UChar *s2, int32_t length, uint32_t options); @@ -604,7 +604,7 @@ u_memcasecmp(const UChar *s1, const UChar *s2, int32_t length, uint32_t options) * @param dst The destination string. * @param src The source string. * @return A pointer to dst. - * @stable + * @stable ICU 2.0 */ U_CAPI UChar* U_EXPORT2 u_strcpy(UChar *dst, @@ -619,7 +619,7 @@ u_strcpy(UChar *dst, * @param src The source string. * @param n The maximum number of characters to copy. * @return A pointer to dst. - * @stable + * @stable ICU 2.0 */ U_CAPI UChar* U_EXPORT2 u_strncpy(UChar *dst, @@ -634,7 +634,7 @@ u_strncpy(UChar *dst, * @param dst The destination string. * @param src The source string. * @return A pointer to dst. - * @stable + * @stable ICU 2.0 */ U_CAPI UChar* U_EXPORT2 u_uastrcpy(UChar *dst, const char *src ); @@ -649,7 +649,7 @@ U_CAPI UChar* U_EXPORT2 u_uastrcpy(UChar *dst, * @param src The source string. * @param n The maximum number of characters to copy. * @return A pointer to dst. - * @stable + * @stable ICU 2.0 */ U_CAPI UChar* U_EXPORT2 u_uastrncpy(UChar *dst, const char *src, @@ -663,7 +663,7 @@ U_CAPI UChar* U_EXPORT2 u_uastrncpy(UChar *dst, * @param dst The destination string. * @param src The source string. * @return A pointer to dst. - * @stable + * @stable ICU 2.0 */ U_CAPI char* U_EXPORT2 u_austrcpy(char *dst, const UChar *src ); @@ -678,7 +678,7 @@ U_CAPI char* U_EXPORT2 u_austrcpy(char *dst, * @param src The source string. * @param n The maximum number of characters to copy. * @return A pointer to dst. - * @stable + * @stable ICU 2.0 */ U_CAPI char* U_EXPORT2 u_austrncpy(char *dst, const UChar *src, @@ -690,7 +690,7 @@ U_CAPI char* U_EXPORT2 u_austrncpy(char *dst, * @param src The source string * @param count The number of characters to copy * @return A pointer to dest - * @stable + * @stable ICU 2.0 */ U_CAPI UChar* U_EXPORT2 u_memcpy(UChar *dest, const UChar *src, int32_t count); @@ -701,7 +701,7 @@ u_memcpy(UChar *dest, const UChar *src, int32_t count); * @param src The source string * @param count The number of characters to move * @return A pointer to dest - * @stable + * @stable ICU 2.0 */ U_CAPI UChar* U_EXPORT2 u_memmove(UChar *dest, const UChar *src, int32_t count); @@ -713,7 +713,7 @@ u_memmove(UChar *dest, const UChar *src, int32_t count); * @param c The character to initialize the string. * @param count The maximum number of characters to set. * @return A pointer to dest. - * @stable + * @stable ICU 2.0 */ U_CAPI UChar* U_EXPORT2 u_memset(UChar *dest, UChar c, int32_t count); @@ -727,7 +727,7 @@ u_memset(UChar *dest, UChar c, int32_t count); * @return When buf1 < buf2, a negative number is returned. * When buf1 == buf2, 0 is returned. * When buf1 > buf2, a positive number is returned. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_memcmp(const UChar *buf1, const UChar *buf2, int32_t count); @@ -743,7 +743,7 @@ u_memcmp(const UChar *buf1, const UChar *buf2, int32_t count); * @return a negative/zero/positive integer corresponding to whether * the first string is less than/equal to/greater than the second one * in code point order - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_memcmpCodePointOrder(const UChar *s1, const UChar *s2, int32_t count); @@ -759,7 +759,7 @@ u_memcmpCodePointOrder(const UChar *s1, const UChar *s2, int32_t count); * @param count The length of the string. * @return A pointer to the first occurrence of c in s * or NULL if c is not in s. - * @stable + * @stable ICU 2.0 * * @see u_strchr * @see u_memchr32 @@ -779,7 +779,7 @@ u_memchr(const UChar *s, UChar c, int32_t count); * @param count The length of the string. * @return A pointer to the first occurrence of c in s * or NULL if c is not in s. - * @stable + * @stable ICU 2.0 * * @see u_strchr32 * @see u_memchr @@ -862,7 +862,7 @@ u_memrchr32(const UChar *s, UChar32 c, int32_t count); * return u_strcmp(ustringVar1, ustringVar2); * } * - * @stable + * @stable ICU 2.0 */ #if U_SIZEOF_WCHAR_T==U_SIZEOF_UCHAR && U_CHARSET_FAMILY==U_ASCII_FAMILY # define U_STRING_DECL(var, cs, length) static const wchar_t var[(length)+1]={ L ## cs } @@ -920,7 +920,7 @@ u_memrchr32(const UChar *s, UChar32 c, int32_t count); * @see u_unescapeAt * @see UnicodeString#unescape() * @see UnicodeString#unescapeAt() - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_unescape(const char *src, @@ -936,7 +936,7 @@ u_unescape(const char *src, * @return the character represented by the escape sequence at * offset * @see u_unescapeAt - * @stable + * @stable ICU 2.0 */ U_CDECL_BEGIN typedef UChar (U_CALLCONV *UNESCAPE_CHAR_AT)(int32_t offset, void *context); @@ -968,7 +968,7 @@ U_CDECL_END * @see u_unescape() * @see UnicodeString#unescape() * @see UnicodeString#unescapeAt() - * @stable + * @stable ICU 2.0 */ U_CAPI UChar32 U_EXPORT2 u_unescapeAt(UNESCAPE_CHAR_AT charAt, @@ -994,7 +994,7 @@ u_unescapeAt(UNESCAPE_CHAR_AT charAt, * which must not indicate a failure before the function call. * @return The length of the result string. It may be greater than destCapacity. In that case, * only some of the result was written to the destination buffer. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_strToUpper(UChar *dest, int32_t destCapacity, @@ -1020,7 +1020,7 @@ u_strToUpper(UChar *dest, int32_t destCapacity, * which must not indicate a failure before the function call. * @return The length of the result string. It may be greater than destCapacity. In that case, * only some of the result was written to the destination buffer. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_strToLower(UChar *dest, int32_t destCapacity, @@ -1097,7 +1097,7 @@ u_strToTitle(UChar *dest, int32_t destCapacity, * which must not indicate a failure before the function call. * @return The length of the result string. It may be greater than destCapacity. In that case, * only some of the result was written to the destination buffer. - * @stable + * @stable ICU 2.0 */ U_CAPI int32_t U_EXPORT2 u_strFoldCase(UChar *dest, int32_t destCapacity, @@ -1122,7 +1122,7 @@ u_strFoldCase(UChar *dest, int32_t destCapacity, * @param pErrorCode Must be a valid pointer to an error code value, * which must not indicate a failure before the function call. * @return The pointer to destination buffer. - * @stable + * @stable ICU 2.0 */ U_CAPI wchar_t* U_EXPORT2 u_strToWCS(wchar_t *dest, @@ -1148,7 +1148,7 @@ u_strToWCS(wchar_t *dest, * @param pErrorCode Must be a valid pointer to an error code value, * which must not indicate a failure before the function call. * @return The pointer to destination buffer. - * @stable + * @stable ICU 2.0 */ U_CAPI UChar* U_EXPORT2 u_strFromWCS(UChar *dest, @@ -1174,7 +1174,7 @@ u_strFromWCS(UChar *dest, * @param pErrorCode Must be a valid pointer to an error code value, * which must not indicate a failure before the function call. * @return The pointer to destination buffer. - * @stable + * @stable ICU 2.0 */ U_CAPI char* U_EXPORT2 u_strToUTF8(char *dest, @@ -1201,7 +1201,7 @@ u_strToUTF8(char *dest, * @param pErrorCode Must be a valid pointer to an error code value, * which must not indicate a failure before the function call. * @return The pointer to destination buffer. - * @stable + * @stable ICU 2.0 */ U_CAPI UChar* U_EXPORT2 u_strFromUTF8(UChar *dest, @@ -1228,7 +1228,7 @@ u_strFromUTF8(UChar *dest, * @param pErrorCode Must be a valid pointer to an error code value, * which must not indicate a failure before the function call. * @return The pointer to destination buffer. - * @stable + * @stable ICU 2.0 */ U_CAPI UChar32* U_EXPORT2 u_strToUTF32(UChar32 *dest, @@ -1255,7 +1255,7 @@ u_strToUTF32(UChar32 *dest, * @param pErrorCode Must be a valid pointer to an error code value, * which must not indicate a failure before the function call. * @return The pointer to destination buffer. - * @stable + * @stable ICU 2.0 */ U_CAPI UChar* U_EXPORT2 u_strFromUTF32(UChar *dest, diff --git a/icu4c/source/common/unicode/utf.h b/icu4c/source/common/unicode/utf.h index bdad0aeefae..4d70e1706f1 100644 --- a/icu4c/source/common/unicode/utf.h +++ b/icu4c/source/common/unicode/utf.h @@ -110,7 +110,7 @@ * \def U_SIZEOF_WCHAR_T * U_SIZEOF_WCHAR_T==sizeof(wchar_t). * - * @stable + * @stable ICU 2.0 */ #ifndef U_HAVE_WCHAR_H # define U_HAVE_WCHAR_H 1 @@ -126,13 +126,13 @@ * \def U_WCHAR_IS_UTF16 * Defined if wchar_t uses UTF-16. * - * @stable + * @stable ICU 2.0 */ /*! * \def U_WCHAR_IS_UTF32 * Defined if wchar_t uses UTF-32. * - * @stable + * @stable ICU 2.0 */ #if !defined(U_WCHAR_IS_UTF16) && !defined(U_WCHAR_IS_UTF32) # ifdef __STDC_ISO_10646__ @@ -167,7 +167,7 @@ * but allows direct string type compatibility with platforms with * 16-bit wchar_t types. * - * @stable + * @stable ICU 2.0 */ /* Define UChar to be compatible with wchar_t if possible. */ diff --git a/icu4c/source/common/unicode/utypes.h b/icu4c/source/common/unicode/utypes.h index 40f92d0d72a..649c2dfd4ee 100644 --- a/icu4c/source/common/unicode/utypes.h +++ b/icu4c/source/common/unicode/utypes.h @@ -519,25 +519,25 @@ typedef enum UErrorCode { #ifdef XP_CPLUSPLUS /** * Does the error code indicate success? - * @stable + * @stable ICU 2.0 */ static inline UBool U_SUCCESS(UErrorCode code) { return (UBool)(code<=U_ZERO_ERROR); } /** * Does the error code indicate a failure? - * @stable + * @stable ICU 2.0 */ static inline UBool U_FAILURE(UErrorCode code) { return (UBool)(code>U_ZERO_ERROR); } #else /** * Does the error code indicate success? - * @stable + * @stable ICU 2.0 */ # define U_SUCCESS(x) ((x)<=U_ZERO_ERROR) /** * Does the error code indicate a failure? - * @stable + * @stable ICU 2.0 */ # define U_FAILURE(x) ((x)>U_ZERO_ERROR) #endif diff --git a/icu4c/source/common/unicode/uversion.h b/icu4c/source/common/unicode/uversion.h index 2d076de0a0c..8dc4195f926 100644 --- a/icu4c/source/common/unicode/uversion.h +++ b/icu4c/source/common/unicode/uversion.h @@ -121,7 +121,7 @@ u_versionToString(UVersionInfo versionArray, char *versionString); * Definition of this function lives in putil.c * * @param versionArray the version # information, the result will be filled in - * @stable + * @stable ICU 2.0 */ U_CAPI void U_EXPORT2 u_getVersion(UVersionInfo versionArray);