organicmaps/icu
13
Fork 0
mirror of https://github.com/unicode-org/icu.git synced 2025-04-16 02:07:15 +00:00
Code Issues1 Projects Releases Wiki Activity Actions10

ICU-8155 Promote appropriate @draft 4.2 and 4.4 API to @stable

Browse source 
X-SVN-Rev: 29035
This commit is contained in:
Peter Edberg 2010-11-12 06:03:28 +00:00
parent c82831a9d7
commit 3384286860
32 changed files with 218 additions and 214 deletions

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

@ -106,14 +106,14 @@ public:
* \code
* if(isFailure()) { handleFailure(); }
* \endcode
* @draft ICU 4.4
* @stable ICU 4.4
*/
void assertSuccess() const;
/**
* Return a string for the UErrorCode value.
* The string will be the same as the name of the error code constant
* in the UErrorCode enum.
* @draft ICU 4.4
* @stable ICU 4.4
*/
const char* errorName() const;

2
icu4c/source/common/unicode/locid.h
View file

@ -180,7 +180,7 @@
U_NAMESPACE_BEGIN
class U_COMMON_API Locale : public UObject {
public:
/** Useful constant for the Root locale. @draft ICU 4.4 */
/** Useful constant for the Root locale. @stable ICU 4.4 */
static const Locale &U_EXPORT2 getRoot(void);
/** Useful constant for this language. @stable ICU 2.0 */
static const Locale &U_EXPORT2 getEnglish(void);

46
icu4c/source/common/unicode/normalizer2.h
View file

@ -73,7 +73,7 @@ U_NAMESPACE_BEGIN
* The set of normalization boundaries returned by these functions may not be
* complete: There may be more boundaries that could be returned.
* Different functions may return different boundaries.
* @draft ICU 4.4
* @stable ICU 4.4
*/
class U_COMMON_API Normalizer2 : public UObject {
public:
@ -96,7 +96,7 @@ public:
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return the requested Normalizer2, if successful
* @draft ICU 4.4
* @stable ICU 4.4
*/
static const Normalizer2 *
getInstance(const char *packageName,
@ -112,7 +112,7 @@ public:
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return normalized src
* @draft ICU 4.4
* @stable ICU 4.4
*/
UnicodeString
normalize(const UnicodeString &src, UErrorCode &errorCode) const {
@ -131,7 +131,7 @@ public:
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return dest
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString &
normalize(const UnicodeString &src,
@ -149,7 +149,7 @@ public:
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return first
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString &
normalizeSecondAndAppend(UnicodeString &first,
@ -167,7 +167,7 @@ public:
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return first
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString &
append(UnicodeString &first,
@ -199,7 +199,7 @@ public:
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return TRUE if s is normalized
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UBool
isNormalized(const UnicodeString &s, UErrorCode &errorCode) const = 0;
@ -217,7 +217,7 @@ public:
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return UNormalizationCheckResult
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UNormalizationCheckResult
quickCheck(const UnicodeString &s, UErrorCode &errorCode) const = 0;
@ -242,7 +242,7 @@ public:
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return "yes" span end index
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual int32_t
spanQuickCheckYes(const UnicodeString &s, UErrorCode &errorCode) const = 0;
@ -258,7 +258,7 @@ public:
* This is used for iterative normalization. See the class documentation for details.
* @param c character to test
* @return TRUE if c has a normalization boundary before it
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UBool hasBoundaryBefore(UChar32 c) const = 0;
@ -274,7 +274,7 @@ public:
* Note that this operation may be significantly slower than hasBoundaryBefore().
* @param c character to test
* @return TRUE if c has a normalization boundary after it
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UBool hasBoundaryAfter(UChar32 c) const = 0;
@ -289,7 +289,7 @@ public:
* Note that this operation may be significantly slower than hasBoundaryBefore().
* @param c character to test
* @return TRUE if c is normalization-inert
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UBool isInert(UChar32 c) const = 0;
@ -307,7 +307,7 @@ private:
* This class implements all of (and only) the Normalizer2 API.
* An instance of this class is unmodifiable/immutable but is constructed and
* must be destructed by the owner.
* @draft ICU 4.4
* @stable ICU 4.4
*/
class U_COMMON_API FilteredNormalizer2 : public Normalizer2 {
public:
@ -319,7 +319,7 @@ public:
* The filter set should be frozen; otherwise the performance will suffer greatly.
* @param n2 wrapped Normalizer2 instance
* @param filterSet UnicodeSet which determines the characters to be normalized
* @draft ICU 4.4
* @stable ICU 4.4
*/
FilteredNormalizer2(const Normalizer2 &n2, const UnicodeSet &filterSet) :
norm2(n2), set(filterSet) {}
@ -335,7 +335,7 @@ public:
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return dest
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString &
normalize(const UnicodeString &src,
@ -353,7 +353,7 @@ public:
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return first
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString &
normalizeSecondAndAppend(UnicodeString &first,
@ -371,7 +371,7 @@ public:
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return first
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString &
append(UnicodeString &first,
@ -400,7 +400,7 @@ public:
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return TRUE if s is normalized
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UBool
isNormalized(const UnicodeString &s, UErrorCode &errorCode) const;
@ -413,7 +413,7 @@ public:
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return UNormalizationCheckResult
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UNormalizationCheckResult
quickCheck(const UnicodeString &s, UErrorCode &errorCode) const;
@ -426,7 +426,7 @@ public:
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return "yes" span end index
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual int32_t
spanQuickCheckYes(const UnicodeString &s, UErrorCode &errorCode) const;
@ -437,7 +437,7 @@ public:
* For details see the Normalizer2 base class documentation.
* @param c character to test
* @return TRUE if c has a normalization boundary before it
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UBool hasBoundaryBefore(UChar32 c) const;
@ -447,7 +447,7 @@ public:
* For details see the Normalizer2 base class documentation.
* @param c character to test
* @return TRUE if c has a normalization boundary after it
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UBool hasBoundaryAfter(UChar32 c) const;
@ -456,7 +456,7 @@ public:
* For details see the Normalizer2 base class documentation.
* @param c character to test
* @return TRUE if c is normalization-inert
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UBool isInert(UChar32 c) const;
private:

8
icu4c/source/common/unicode/platform.h.in
View file

@ -35,7 +35,7 @@
/**
* Determine wheter to enable auto cleanup of libraries.
* @draft ICU 4.4
* @stable ICU 4.4
*/
#ifndef UCLN_NO_AUTO_CLEANUP
#define UCLN_NO_AUTO_CLEANUP @UCLN_NO_AUTO_CLEANUP@
@ -87,7 +87,7 @@
* For platforms that do not use platform.h and do not define this constant
* in their platform-specific headers, std_string.h defaults
* U_HAVE_STD_STRING to 1.
* @draft ICU 4.2
* @stable ICU 4.2
*/
#ifndef U_HAVE_STD_STRING
#define U_HAVE_STD_STRING @U_HAVE_STD_STRING@
@ -186,7 +186,7 @@
/**
* Whether to enable Dynamic loading in ICU
* @draft ICU 4.4
* @stable ICU 4.4
*/
#ifndef U_ENABLE_DYLOAD
#define U_ENABLE_DYLOAD @U_ENABLE_DYLOAD@
@ -194,7 +194,7 @@
/**
* Whether to test Dynamic loading as an OS capabilty
* @draft ICU 4.4
* @stable ICU 4.4
*/
#ifndef U_CHECK_DYLOAD
#define U_CHECK_DYLOAD @U_CHECK_DYLOAD@

2
icu4c/source/common/unicode/std_string.h
View file

@ -28,7 +28,7 @@
/**
* \def U_HAVE_STD_STRING
* Define whether the standard C++ (STL) <string> header is available.
* @draft ICU 4.2
* @stable ICU 4.2
*/
#ifndef U_HAVE_STD_STRING
#define U_HAVE_STD_STRING 1

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

@ -870,7 +870,7 @@ public:
* @param spanCondition specifies the containment condition
* @return the exclusive end of the substring according to the spanCondition;
* the substring s.tempSubStringBetween(start, end) fulfills the spanCondition
* @draft ICU 4.4
* @stable ICU 4.4
* @see USetSpanCondition
*/
inline int32_t span(const UnicodeString &s, int32_t start, USetSpanCondition spanCondition) const;
@ -904,7 +904,7 @@ public:
* @param spanCondition specifies the containment condition
* @return the start of the substring according to the spanCondition;
* the substring s.tempSubStringBetween(start, limit) fulfills the spanCondition
* @draft ICU 4.4
* @stable ICU 4.4
* @see USetSpanCondition
*/
inline int32_t spanBack(const UnicodeString &s, int32_t limit, USetSpanCondition spanCondition) const;

6
icu4c/source/common/unicode/unistr.h
View file

@ -1577,7 +1577,7 @@ public:
* @param start offset of the first character visible in the substring
* @param length length of the substring
* @return a read-only alias UnicodeString object for the substring
* @draft ICU 4.4
* @stable ICU 4.4
*/
UnicodeString tempSubString(int32_t start=0, int32_t length=INT32_MAX) const;
@ -1589,7 +1589,7 @@ public:
* @param start offset of the first character visible in the substring
* @param limit offset immediately following the last character visible in the substring
* @return a read-only alias UnicodeString object for the substring
* @draft ICU 4.4
* @stable ICU 4.4
*/
inline UnicodeString tempSubStringBetween(int32_t start, int32_t limit=INT32_MAX) const;
@ -2432,7 +2432,7 @@ public:
* @param start the offset of the first character to retain
* @param limit the offset immediately following the range to retain
* @return a reference to this
* @draft ICU 4.4
* @stable ICU 4.4
*/
inline UnicodeString &retainBetween(int32_t start, int32_t limit = INT32_MAX);

62
icu4c/source/common/unicode/unorm2.h
View file

@ -37,7 +37,7 @@
* For details about standard Unicode normalization forms
* and about the algorithms which are also used with custom mapping tables
* see http://www.unicode.org/unicode/reports/tr15/
* @draft ICU 4.4
* @stable ICU 4.4
*/
typedef enum {
/**
@ -46,7 +46,7 @@ typedef enum {
* Same as standard NFKC when using an "nfkc" instance.
* For details about standard Unicode normalization forms
* see http://www.unicode.org/unicode/reports/tr15/
* @draft ICU 4.4
* @stable ICU 4.4
*/
UNORM2_COMPOSE,
/**
@ -55,7 +55,7 @@ typedef enum {
* Same as standard NFKD when using an "nfkc" instance.
* For details about standard Unicode normalization forms
* see http://www.unicode.org/unicode/reports/tr15/
* @draft ICU 4.4
* @stable ICU 4.4
*/
UNORM2_DECOMPOSE,
/**
@ -68,7 +68,7 @@ typedef enum {
* Not a standard Unicode normalization form.
* Not a unique form: Different FCD strings can be canonically equivalent.
* For details see http://www.unicode.org/notes/tn5/#FCD
* @draft ICU 4.4
* @stable ICU 4.4
*/
UNORM2_FCD,
/**
@ -78,7 +78,7 @@ typedef enum {
* The result will conform to FCD which is useful for processing.
* Not a standard Unicode normalization form.
* For details see http://www.unicode.org/notes/tn5/#FCC
* @draft ICU 4.4
* @stable ICU 4.4
*/
UNORM2_COMPOSE_CONTIGUOUS
} UNormalization2Mode;
@ -111,10 +111,10 @@ typedef enum UNormalizationCheckResult {
/**
* Opaque C service object type for the new normalization API.
* @draft ICU 4.4
* @stable ICU 4.4
*/
struct UNormalizer2;
typedef struct UNormalizer2 UNormalizer2; /**< C typedef for struct UNormalizer2. @draft ICU 4.4 */
typedef struct UNormalizer2 UNormalizer2; /**< C typedef for struct UNormalizer2. @stable ICU 4.4 */
#if !UCONFIG_NO_NORMALIZATION
@ -137,9 +137,9 @@ typedef struct UNormalizer2 UNormalizer2; /**< C typedef for struct UNormalizer
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return the requested UNormalizer2, if successful
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT const UNormalizer2 * U_EXPORT2
U_STABLE const UNormalizer2 * U_EXPORT2
unorm2_getInstance(const char *packageName,
const char *name,
UNormalization2Mode mode,
@ -158,18 +158,18 @@ unorm2_getInstance(const char *packageName,
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return the requested UNormalizer2, if successful
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT UNormalizer2 * U_EXPORT2
U_STABLE UNormalizer2 * U_EXPORT2
unorm2_openFiltered(const UNormalizer2 *norm2, const USet *filterSet, UErrorCode *pErrorCode);
/**
* Closes a UNormalizer2 instance from unorm2_openFiltered().
* Do not close instances from unorm2_getInstance()!
* @param norm2 UNormalizer2 instance to be closed
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT void U_EXPORT2
U_STABLE void U_EXPORT2
unorm2_close(UNormalizer2 *norm2);
#if U_SHOW_CPLUSPLUS_API
@ -205,9 +205,9 @@ U_NAMESPACE_END
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return dest
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
unorm2_normalize(const UNormalizer2 *norm2,
const UChar *src, int32_t length,
UChar *dest, int32_t capacity,
@ -228,9 +228,9 @@ unorm2_normalize(const UNormalizer2 *norm2,
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return first
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
unorm2_normalizeSecondAndAppend(const UNormalizer2 *norm2,
UChar *first, int32_t firstLength, int32_t firstCapacity,
const UChar *second, int32_t secondLength,
@ -251,9 +251,9 @@ unorm2_normalizeSecondAndAppend(const UNormalizer2 *norm2,
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return first
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
unorm2_append(const UNormalizer2 *norm2,
UChar *first, int32_t firstLength, int32_t firstCapacity,
const UChar *second, int32_t secondLength,
@ -294,9 +294,9 @@ unorm2_getDecomposition(const UNormalizer2 *norm2,
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return TRUE if s is normalized
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT UBool U_EXPORT2
U_STABLE UBool U_EXPORT2
unorm2_isNormalized(const UNormalizer2 *norm2,
const UChar *s, int32_t length,
UErrorCode *pErrorCode);
@ -316,9 +316,9 @@ unorm2_isNormalized(const UNormalizer2 *norm2,
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return UNormalizationCheckResult
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT UNormalizationCheckResult U_EXPORT2
U_STABLE UNormalizationCheckResult U_EXPORT2
unorm2_quickCheck(const UNormalizer2 *norm2,
const UChar *s, int32_t length,
UErrorCode *pErrorCode);
@ -345,9 +345,9 @@ unorm2_quickCheck(const UNormalizer2 *norm2,
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return "yes" span end index
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
unorm2_spanQuickCheckYes(const UNormalizer2 *norm2,
const UChar *s, int32_t length,
UErrorCode *pErrorCode);
@ -359,9 +359,9 @@ unorm2_spanQuickCheckYes(const UNormalizer2 *norm2,
* @param norm2 UNormalizer2 instance
* @param c character to test
* @return TRUE if c has a normalization boundary before it
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT UBool U_EXPORT2
U_STABLE UBool U_EXPORT2
unorm2_hasBoundaryBefore(const UNormalizer2 *norm2, UChar32 c);
/**
@ -371,9 +371,9 @@ unorm2_hasBoundaryBefore(const UNormalizer2 *norm2, UChar32 c);
* @param norm2 UNormalizer2 instance
* @param c character to test
* @return TRUE if c has a normalization boundary after it
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT UBool U_EXPORT2
U_STABLE UBool U_EXPORT2
unorm2_hasBoundaryAfter(const UNormalizer2 *norm2, UChar32 c);
/**
@ -382,9 +382,9 @@ unorm2_hasBoundaryAfter(const UNormalizer2 *norm2, UChar32 c);
* @param norm2 UNormalizer2 instance
* @param c character to test
* @return TRUE if c is normalization-inert
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT UBool U_EXPORT2
U_STABLE UBool U_EXPORT2
unorm2_isInert(const UNormalizer2 *norm2, UChar32 c);
#endif /* !UCONFIG_NO_NORMALIZATION */

36
icu4c/source/common/unicode/ushape.h
View file

@ -113,7 +113,7 @@ u_shapeArabic(const UChar *source, int32_t sourceLength,
* Memory option: allow the result to have a different length than the source.
* Affects: LamAlef options
* This option is an alias to U_SHAPE_LENGTH_GROW_SHRINK
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_SHAPE_LAMALEF_RESIZE 0
@ -129,7 +129,7 @@ u_shapeArabic(const UChar *source, int32_t sourceLength,
* If more room is necessary, then try to consume spaces next to modified characters.
* Affects: LamAlef options
* This option is an alias to U_SHAPE_LENGTH_FIXED_SPACES_NEAR
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_SHAPE_LAMALEF_NEAR 1
@ -145,7 +145,7 @@ u_shapeArabic(const UChar *source, int32_t sourceLength,
* If more room is necessary, then try to consume spaces at the end of the text.
* Affects: LamAlef options
* This option is an alias to U_SHAPE_LENGTH_FIXED_SPACES_AT_END
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_SHAPE_LAMALEF_END 2
@ -161,7 +161,7 @@ u_shapeArabic(const UChar *source, int32_t sourceLength,
* If more room is necessary, then try to consume spaces at the beginning of the text.
* Affects: LamAlef options
* This option is an alias to U_SHAPE_LENGTH_FIXED_SPACES_AT_BEGINNING
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_SHAPE_LAMALEF_BEGIN 3
@ -177,7 +177,7 @@ u_shapeArabic(const UChar *source, int32_t sourceLength,
*
* Deshaping Mode: Perform the same function as the flag equals U_SHAPE_LAMALEF_END.
* Affects: LamAlef options
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_SHAPE_LAMALEF_AUTO 0x10000
@ -187,7 +187,7 @@ u_shapeArabic(const UChar *source, int32_t sourceLength,
/**
* Bit mask for LamAlef memory options.
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_SHAPE_LAMALEF_MASK 0x10003 /* updated */
@ -199,7 +199,7 @@ u_shapeArabic(const UChar *source, int32_t sourceLength,
* the source is in visual RTL order,
* the rightmost displayed character stored first.
* This option is an alias to U_SHAPE_TEXT_DIRECTION_LOGICAL
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_SHAPE_TEXT_DIRECTION_VISUAL_RTL 0
@ -339,13 +339,13 @@ u_shapeArabic(const UChar *source, int32_t sourceLength,
* De-shaping mode: Any Seen character followed by Tail character will be
* replaced by one cell Seen and a space will replace the Tail.
* Affects: Seen options
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_SHAPE_SEEN_TWOCELL_NEAR 0x200000
/**
* Bit mask for Seen memory options.
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_SHAPE_SEEN_MASK 0x700000
@ -360,14 +360,14 @@ u_shapeArabic(const UChar *source, int32_t sourceLength,
* De-shaping mode: Any Yeh (final or isolated) character followed by Hamza character will be
* replaced by one cell YehHamza and space will replace the Hamza.
* Affects: YehHamza options
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_SHAPE_YEHHAMZA_TWOCELL_NEAR 0x1000000
/**
* Bit mask for YehHamza memory options.
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_SHAPE_YEHHAMZA_MASK 0x3800000
@ -379,7 +379,7 @@ u_shapeArabic(const UChar *source, int32_t sourceLength,
*
* De-shaping mode: N/A
* Affects: Tashkeel options
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_SHAPE_TASHKEEL_BEGIN 0x40000
@ -390,7 +390,7 @@ u_shapeArabic(const UChar *source, int32_t sourceLength,
*
* De-shaping mode: N/A
* Affects: Tashkeel options
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_SHAPE_TASHKEEL_END 0x60000
@ -400,7 +400,7 @@ u_shapeArabic(const UChar *source, int32_t sourceLength,
* De-shaping mode: N/A
*
* Affect: Tashkeel options
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_SHAPE_TASHKEEL_RESIZE 0x80000
@ -411,13 +411,13 @@ u_shapeArabic(const UChar *source, int32_t sourceLength,
*
* De-shaping mode: N/A
* Affects: YehHamza options
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_SHAPE_TASHKEEL_REPLACE_BY_TATWEEL 0xC0000
/**
* Bit mask for Tashkeel replacement with Space or Tatweel memory options.
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_SHAPE_TASHKEEL_MASK 0xE0000
@ -441,13 +441,13 @@ u_shapeArabic(const UChar *source, int32_t sourceLength,
* to the physical memory address beginning for Visual LTR text, Same as BEGIN in default behavior.
* D. END For Logical text: Same as END in default behavior).
* Affects: All LamAlef BEGIN, END and AUTO options.
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_SHAPE_SPACES_RELATIVE_TO_TEXT_BEGIN_END 0x4000000
/**
* Bit mask for swapping BEGIN and END for Visual LTR text
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_SHAPE_SPACES_RELATIVE_TO_TEXT_MASK 0x4000000

8
icu4c/source/common/unicode/ustring.h
View file

@ -1630,11 +1630,11 @@ u_strFromUTF32WithSub(UChar *dest,
* immediately. Check for U_FAILURE() on output or use with
* function chaining. (See User Guide for details.)
* @return The pointer to destination buffer.
* @draft ICU 4.4
* @stable ICU 4.4
* @see u_strToUTF8WithSub
* @see u_strFromJavaModifiedUTF8WithSub
*/
U_DRAFT char* U_EXPORT2
U_STABLE char* U_EXPORT2
u_strToJavaModifiedUTF8(
char *dest,
int32_t destCapacity,
@ -1681,9 +1681,9 @@ u_strToJavaModifiedUTF8(
* @see u_strFromUTF8WithSub
* @see u_strFromUTF8Lenient
* @see u_strToJavaModifiedUTF8
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT UChar* U_EXPORT2
U_STABLE UChar* U_EXPORT2
u_strFromJavaModifiedUTF8WithSub(
UChar *dest,
int32_t destCapacity,

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

@ -1,7 +1,7 @@
/*
*******************************************************************************
*
* Copyright (C) 1999-2008, International Business Machines
* Copyright (C) 1999-2010, International Business Machines
* Corporation and others. All Rights Reserved.
*
*******************************************************************************
@ -221,7 +221,7 @@
* is it a trail surrogate?
* @param c 32-bit code point
* @return TRUE or FALSE
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U_IS_SURROGATE_TRAIL(c) (((c)&0x400)!=0)

2
icu4c/source/common/unicode/utf16.h
View file

@ -87,7 +87,7 @@
* is it a trail surrogate?
* @param c 16-bit code unit
* @return TRUE or FALSE
* @draft ICU 4.2
* @stable ICU 4.2
*/
#define U16_IS_SURROGATE_TRAIL(c) (((c)&0x400)!=0)

2
icu4c/source/common/unicode/utypes.h
View file

@ -178,7 +178,7 @@
* configuration option (see unicode/uconfig.h)
* - the UCONFIG_NO_CONVERSION build option in uconfig.h is more usable
*
* @draft ICU 4.2
* @stable ICU 4.2
* @see UCONFIG_NO_CONVERSION
*/
#ifndef U_CHARSET_IS_UTF8

2
icu4c/source/common/unicode/uvernum.h
View file

@ -80,7 +80,7 @@
* This value will change in the subsequent releases of ICU.
* If a custom suffix (such as matching library suffixes) is desired, this can be modified.
* Note that if present, platform.h may contain an earlier definition of this macro.
* @draft ICU 4.2
* @stable ICU 4.2
*/
#ifndef U_ICU_ENTRY_POINT_RENAME
#define U_ICU_ENTRY_POINT_RENAME(x) x ## _46

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

@ -1203,7 +1203,7 @@ public:
* @param dayOfWeek The day of the week whose type is desired (UCAL_SUNDAY..UCAL_SATURDAY).
* @param status The error code for the operation.
* @return The UCalendarWeekdayType for the day of the week.
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UCalendarWeekdayType getDayOfWeekType(UCalendarDaysOfWeek dayOfWeek, UErrorCode &status) const;
@ -1219,7 +1219,7 @@ public:
* desired (UCAL_SUNDAY..UCAL_SATURDAY).
* @param status The error code for the operation.
* @return The milliseconds after midnight at which the weekend begins or ends.
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual int32_t getWeekendTransition(UCalendarDaysOfWeek dayOfWeek, UErrorCode &status) const;
@ -1230,7 +1230,7 @@ public:
* @param status The error code for the operation.
* @return TRUE if the given UDate is in the weekend in
* this calendar system, FALSE otherwise.
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UBool isWeekend(UDate date, UErrorCode &status) const;
@ -1239,7 +1239,7 @@ public:
* this calendar system.
* @return TRUE if this Calendar's current date-time is in the weekend in
* this calendar system, FALSE otherwise.
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UBool isWeekend(void) const;

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

@ -246,7 +246,7 @@ public:
* are defined in UDateFormatField. Can be NULL.
* @param status Output param filled with success/failure status.
* @return Reference to 'appendTo' parameter.
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString& format(const Formattable& obj,
UnicodeString& appendTo,
@ -305,7 +305,7 @@ public:
* are defined in UDateFormatField. Can be NULL.
* @param status error status.
* @return Reference to 'appendTo' parameter.
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString& format(Calendar& cal,
UnicodeString& appendTo,
@ -353,7 +353,7 @@ public:
* are defined in UDateFormatField. Can be NULL.
* @param status error status.
* @return Reference to 'appendTo' parameter.
* @draft ICU 4.4
* @stable ICU 4.4
*/
UnicodeString& format(UDate date,
UnicodeString& appendTo,

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

@ -856,7 +856,7 @@ public:
* Can be NULL.
* @param status Output param filled with success/failure status.
* @return Reference to 'appendTo' parameter.
* @draft 4.4
* @stable 4.4
*/
virtual UnicodeString& format(double number,
UnicodeString& appendTo,
@ -889,7 +889,7 @@ public:
* Can be NULL.
* @param status Output param filled with success/failure status.
* @return Reference to 'appendTo' parameter.
* @draft 4.4
* @stable 4.4
*/
virtual UnicodeString& format(int32_t number,
UnicodeString& appendTo,
@ -922,7 +922,7 @@ public:
* Can be NULL.
* @param status Output param filled with success/failure status.
* @return Reference to 'appendTo' parameter.
* @draft 4.4
* @stable 4.4
*/
virtual UnicodeString& format(int64_t number,
UnicodeString& appendTo,
@ -943,7 +943,7 @@ public:
* Can be NULL.
* @param status Output param filled with success/failure status.
* @return Reference to 'appendTo' parameter.
* @draft 4.4
* @stable 4.4
*/
virtual UnicodeString& format(const StringPiece &number,
UnicodeString& appendTo,

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

@ -1,6 +1,6 @@
/*
*******************************************************************************
* Copyright (C) 2007-2009, International Business Machines Corporation and
* Copyright (C) 2007-2010, International Business Machines Corporation and
* others. All Rights Reserved.
*******************************************************************************
*
@ -270,7 +270,7 @@ public:
* which must not indicate a failure before the function call.
* @return bestPattern
* The best pattern found from the given skeleton.
* @draft ICU 4.4
* @stable ICU 4.4
*/
UnicodeString getBestPattern(const UnicodeString& skeleton,
UDateTimePatternMatchOptions options,
@ -317,7 +317,7 @@ public:
* Output param set to success/failure code on exit,
* which must not indicate a failure before the function call.
* @return pattern adjusted to match the skeleton fields widths and subtypes.
* @draft ICU 4.4
* @stable ICU 4.4
*/
UnicodeString replaceFieldTypes(const UnicodeString& pattern,
const UnicodeString& skeleton,

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

@ -118,7 +118,7 @@ public:
* @param status the error code. Possible errors include U_INVALID_FORMAT_ERROR
* if the format of the string does not conform to that of a
* decimal number.
* @draft ICU 4.4
* @stable ICU 4.4
*/
Formattable(const StringPiece &number, UErrorCode &status);
@ -476,7 +476,7 @@ public:
*
* @param status the error code.
* @return the unformatted string representation of a number.
* @draft ICU 4.4
* @stable ICU 4.4
*/
StringPiece getDecimalNumber(UErrorCode &status);
@ -565,7 +565,7 @@ public:
* @param numberString a string representation of the unformatted decimal number.
* @param status the error code. Set to U_INVALID_FORMAT_ERROR if the
* incoming string is not a valid decimal number.
* @draft ICU 4.4
* @stable ICU 4.4
*/
void setDecimalNumber(const StringPiece &numberString,
UErrorCode &status);

2
icu4c/source/i18n/unicode/format.h
View file

@ -174,7 +174,7 @@ public:
* of fields generated by this format call.
* @param status Output param filled with success/failure status.
* @return Reference to 'appendTo' parameter.
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString& format(const Formattable& obj,
UnicodeString& appendTo,

14
icu4c/source/i18n/unicode/fpositer.h
View file

@ -48,26 +48,26 @@ class UVector32;
/**
* FieldPositionIterator returns the field ids and their start/limit positions generated
* by a call to Format::format. See Format, NumberFormat, DecimalFormat.
* @draft ICU 4.4
* @stable ICU 4.4
*/
class U_I18N_API FieldPositionIterator : public UObject {
public:
/**
* Destructor.
* @draft ICU 4.4
* @stable ICU 4.4
*/
~FieldPositionIterator();
/**
* Constructs a new, empty iterator.
* @draft ICU 4.4
* @stable ICU 4.4
*/
FieldPositionIterator(void);
/**
* Copy constructor. If the copy failed for some reason, the new iterator will
* be empty.
* @draft ICU 4.4
* @stable ICU 4.4
*/
FieldPositionIterator(const FieldPositionIterator&);
@ -77,7 +77,7 @@ public:
* <p>
* Return true if this FieldPositionIterator is at the same position in an
* equal array of run values.
* @draft ICU 4.4
* @stable ICU 4.4
*/
UBool operator==(const FieldPositionIterator&) const;
@ -85,14 +85,14 @@ public:
* Returns the complement of the result of operator==
* @param rhs The FieldPositionIterator to be compared for inequality
* @return the complement of the result of operator==
* @draft ICU 4.4
* @stable ICU 4.4
*/
UBool operator!=(const FieldPositionIterator& rhs) const { return !operator==(rhs); }
/**
* If the current position is valid, updates the FieldPosition values, advances the iterator,
* and returns TRUE, otherwise returns FALSE.
* @draft ICU 4.4
* @stable ICU 4.4
*/
UBool next(FieldPosition& fp);

30
icu4c/source/i18n/unicode/locdspnm.h
View file

@ -27,13 +27,13 @@ U_NAMESPACE_BEGIN
* Returns display names of Locales and components of Locales. For
* more information on language, script, region, variant, key, and
* values, see Locale.
* @draft ICU 4.4
* @stable ICU 4.4
*/
class U_I18N_API LocaleDisplayNames : public UObject {
public:
/**
* Destructor.
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual ~LocaleDisplayNames();
@ -43,7 +43,7 @@ public:
* that specifies STANDARD dialect handling.
* @param locale the display locale
* @return a LocaleDisplayNames instance
* @draft ICU 4.4
* @stable ICU 4.4
*/
static LocaleDisplayNames* U_EXPORT2 createInstance(const Locale& locale);
@ -55,7 +55,7 @@ public:
* @param locale the display locale
* @param dialectHandling how to select names for locales
* @return a LocaleDisplayNames instance
* @draft ICU 4.4
* @stable ICU 4.4
*/
static LocaleDisplayNames* U_EXPORT2 createInstance(const Locale& locale,
UDialectHandling dialectHandling);
@ -65,14 +65,14 @@ public:
* Returns the locale used to determine the display names. This is
* not necessarily the same locale passed to {@link #getInstance}.
* @return the display locale
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual const Locale& getLocale() const = 0;
/**
* Returns the dialect handling used in the display names.
* @return the dialect handling enum
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UDialectHandling getDialectHandling() const = 0;
@ -82,7 +82,7 @@ public:
* @param locale the locale whose display name to return
* @param result receives the locale's display name
* @return the display name of the provided locale
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString& localeDisplayName(const Locale& locale,
UnicodeString& result) const = 0;
@ -92,7 +92,7 @@ public:
* @param localeId the id of the locale whose display name to return
* @param result receives the locale's display name
* @return the display name of the provided locale
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString& localeDisplayName(const char* localeId,
UnicodeString& result) const = 0;
@ -103,7 +103,7 @@ public:
* @param lang the language code
* @param result receives the language code's display name
* @return the display name of the provided language code
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString& languageDisplayName(const char* lang,
UnicodeString& result) const = 0;
@ -113,7 +113,7 @@ public:
* @param script the script code
* @param result receives the script code's display name
* @return the display name of the provided script code
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString& scriptDisplayName(const char* script,
UnicodeString& result) const = 0;
@ -123,7 +123,7 @@ public:
* @param scriptCode the script code number
* @param result receives the script code's display name
* @return the display name of the provided script code
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString& scriptDisplayName(UScriptCode scriptCode,
UnicodeString& result) const = 0;
@ -133,7 +133,7 @@ public:
* @param region the region code
* @param result receives the region code's display name
* @return the display name of the provided region code
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString& regionDisplayName(const char* region,
UnicodeString& result) const = 0;
@ -143,7 +143,7 @@ public:
* @param variant the variant string
* @param result receives the variant's display name
* @return the display name of the provided variant
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString& variantDisplayName(const char* variant,
UnicodeString& result) const = 0;
@ -153,7 +153,7 @@ public:
* @param key the locale key name
* @param result receives the locale key's display name
* @return the display name of the provided locale key
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString& keyDisplayName(const char* key,
UnicodeString& result) const = 0;
@ -164,7 +164,7 @@ public:
* @param value the locale key's value
* @param result receives the value's display name
* @return the display name of the provided value
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString& keyValueDisplayName(const char* key, const char* value,
UnicodeString& result) const = 0;

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

@ -271,7 +271,7 @@ public:
* NULL.
* @param status Output param filled with success/failure status.
* @return Reference to 'appendTo' parameter.
* @draft 4.4
* @stable 4.4
*/
virtual UnicodeString& format(const Formattable& obj,
UnicodeString& appendTo,
@ -376,7 +376,7 @@ public:
* Can be NULL.
* @param status Output param filled with success/failure status.
* @return Reference to 'appendTo' parameter.
* @draft 4.4
* @stable 4.4
*/
virtual UnicodeString& format(double number,
UnicodeString& appendTo,
@ -410,7 +410,7 @@ public:
* Can be NULL.
* @param status Output param filled with success/failure status.
* @return Reference to 'appendTo' parameter.
* @draft 4.4
* @stable 4.4
*/
virtual UnicodeString& format(int32_t number,
UnicodeString& appendTo,
@ -444,7 +444,7 @@ public:
* Can be NULL.
* @param status Output param filled with success/failure status.
* @return Reference to 'appendTo' parameter.
* @draft 4.4
* @stable 4.4
*/
virtual UnicodeString& format(int64_t number,
UnicodeString& appendTo,
@ -465,7 +465,7 @@ public:
* Can be NULL.
* @param status Output param filled with success/failure status.
* @return Reference to 'appendTo' parameter.
* @draft 4.4
* @stable 4.4
*/
virtual UnicodeString& format(const StringPiece &number,
UnicodeString& appendTo,

26
icu4c/source/i18n/unicode/selfmt.h
View file

@ -178,7 +178,7 @@ class Hashtable;
* <code>Kirti est all&#x00E9;e &#x00E0; Paris.</code>
* \endhtmlonly
*
* @draft ICU 4.4
* @stable ICU 4.4
*/
class U_I18N_API SelectFormat : public Format {
@ -190,19 +190,19 @@ public:
* errors are returned to status if the pattern is invalid.
* @param status output param set to success/failure code on exit, which
* must not indicate a failure before the function call.
* @draft ICU 4.4
* @stable ICU 4.4
*/
SelectFormat(const UnicodeString& pattern, UErrorCode& status);
/**
* copy constructor.
* @draft ICU 4.4
* @stable ICU 4.4
*/
SelectFormat(const SelectFormat& other);
/**
* Destructor.
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual ~SelectFormat();
@ -215,7 +215,7 @@ public:
* errors are returned to status if the pattern is invalid.
* @param status output param set to success/failure code on exit, which
* must not indicate a failure before the function call.
* @draft ICU 4.4
* @stable ICU 4.4
*/
void applyPattern(const UnicodeString& pattern, UErrorCode& status);
@ -233,7 +233,7 @@ public:
* @param status output param set to success/failure code on exit, which
* must not indicate a failure before the function call.
* @return Reference to 'appendTo' parameter.
* @draft ICU 4.4
* @stable ICU 4.4
*/
UnicodeString& format(const UnicodeString& keyword,
UnicodeString& appendTo,
@ -244,7 +244,7 @@ public:
* Assignment operator
*
* @param other the SelectFormat object to copy from.
* @draft ICU 4.4
* @stable ICU 4.4
*/
SelectFormat& operator=(const SelectFormat& other);
@ -253,7 +253,7 @@ public:
*
* @param other the SelectFormat object to be compared with.
* @return true if other is semantically equal to this.
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UBool operator==(const Format& other) const;
@ -262,14 +262,14 @@ public:
*
* @param other the SelectFormat object to be compared with.
* @return true if other is semantically unequal to this.
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UBool operator!=(const Format& other) const;
/**
* Clones this Format object polymorphically. The caller owns the
* result and should delete it when done.
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual Format* clone(void) const;
@ -286,7 +286,7 @@ public:
* On output: the offsets of the alignment field.
* @param status output param filled with success/failure status.
* @return Reference to 'appendTo' parameter.
* @draft ICU 4.4
* @stable ICU 4.4
*/
UnicodeString& format(const Formattable& obj,
UnicodeString& appendTo,
@ -299,7 +299,7 @@ public:
* @param appendTo output parameter to receive result.
* Result is appended to existing contents.
* @return the UnicodeString with inserted pattern.
* @draft ICU 4.4
* @stable ICU 4.4
*/
UnicodeString& toPattern(UnicodeString& appendTo);
@ -323,7 +323,7 @@ public:
* last character successfully parsed. If the
* source is not parsed successfully, this param
* will remain unchanged.
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual void parseObject(const UnicodeString& source,
Formattable& result,

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

@ -406,7 +406,7 @@ public:
* are defined in UDateFormatField.
* @param status Input/output param set to success/failure code.
* @return Reference to 'appendTo' parameter.
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString& format( Calendar& cal,
UnicodeString& appendTo,
@ -455,7 +455,7 @@ public:
* are defined in UDateFormatField.
* @param status Input/output param set to success/failure code.
* @return Reference to 'appendTo' parameter.
* @draft ICU 4.4
* @stable ICU 4.4
*/
virtual UnicodeString& format( const Formattable& obj,
UnicodeString& appendTo,
@ -486,7 +486,7 @@ public:
* are defined in UDateFormatField.
* @param status Input/output param set to success/failure code.
* @return Reference to 'appendTo' parameter.
* @draft ICU 4.4
* @stable ICU 4.4
*/
UnicodeString& format(UDate date,
UnicodeString& appendTo,

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

@ -158,7 +158,7 @@ enum UCalendarType {
UCAL_TRADITIONAL,
/**
* A better name for UCAL_TRADITIONAL.
* @draft ICU 4.2
* @stable ICU 4.2
*/
UCAL_DEFAULT = UCAL_TRADITIONAL,
/**
@ -1199,30 +1199,34 @@ ucal_getKeywordValuesForLocale(const char* key,
/** Weekday types, as returned by ucal_getDayOfWeekType().
* @draft ICU 4.4
* @stable ICU 4.4
*/
enum UCalendarWeekdayType {
/**
* Designates a full weekday (no part of the day is included in the weekend).
* @stable ICU 4.4
*/
UCAL_WEEKDAY,
/**
* Designates a full weekend day (the entire day is included in the weekend).
* @stable ICU 4.4
*/
UCAL_WEEKEND,
/**
* Designates a day that starts as a weekday and transitions to the weekend.
* Call ucal_getWeekendTransition() to get the time of transition.
* @stable ICU 4.4
*/
UCAL_WEEKEND_ONSET,
/**
* Designates a day that starts as the weekend and transitions to a weekday.
* Call ucal_getWeekendTransition() to get the time of transition.
* @stable ICU 4.4
*/
UCAL_WEEKEND_CEASE
};
/** @draft ICU 4.4 */
/** @stable ICU 4.4 */
typedef enum UCalendarWeekdayType UCalendarWeekdayType;
/**
@ -1239,9 +1243,9 @@ typedef enum UCalendarWeekdayType UCalendarWeekdayType;
* @param dayOfWeek The day of the week whose type is desired (UCAL_SUNDAY..UCAL_SATURDAY).
* @param status The error code for the operation.
* @return The UCalendarWeekdayType for the day of the week.
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT UCalendarWeekdayType U_EXPORT2
U_STABLE UCalendarWeekdayType U_EXPORT2
ucal_getDayOfWeekType(const UCalendar *cal, UCalendarDaysOfWeek dayOfWeek, UErrorCode* status);
/**
@ -1257,9 +1261,9 @@ ucal_getDayOfWeekType(const UCalendar *cal, UCalendarDaysOfWeek dayOfWeek, UErro
* desired (UCAL_SUNDAY..UCAL_SATURDAY).
* @param status The error code for the operation.
* @return The milliseconds after midnight at which the weekend begins or ends.
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
ucal_getWeekendTransition(const UCalendar *cal, UCalendarDaysOfWeek dayOfWeek, UErrorCode *status);
/**
@ -1270,9 +1274,9 @@ ucal_getWeekendTransition(const UCalendar *cal, UCalendarDaysOfWeek dayOfWeek, U
* @param status The error code for the operation.
* @return TRUE if the given UDate is in the weekend in
* this calendar system, FALSE otherwise.
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT UBool U_EXPORT2
U_STABLE UBool U_EXPORT2
ucal_isWeekend(const UCalendar *cal, UDate date, UErrorCode *status);

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

@ -503,9 +503,9 @@ typedef enum UDateFormatField {
* @param field the UDateFormatField.
* @return the UCalendarDateField. This will be UCAL_FIELD_COUNT in case
* of error (e.g., the input field is UDAT_FIELD_COUNT).
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT UCalendarDateFields U_EXPORT2
U_STABLE UCalendarDateFields U_EXPORT2
udat_toCalendarDateField(UDateFormatField field);

16
icu4c/source/i18n/unicode/udatpg.h
View file

@ -92,18 +92,18 @@ typedef enum UDateTimePatternField {
* pattern to match those in the skeleton (when this would not happen
* otherwise). These may be combined to force the length of multiple fields.
* Used with udatpg_getBestPatternWithOptions, udatpg_replaceFieldTypesWithOptions.
* @draft ICU 4.4
* @stable ICU 4.4
*/
typedef enum UDateTimePatternMatchOptions {
/** @draft ICU 4.4 */
/** @stable ICU 4.4 */
UDATPG_MATCH_NO_OPTIONS = 0,
/** @draft ICU 4.4 */
/** @stable ICU 4.4 */
UDATPG_MATCH_HOUR_FIELD_LENGTH = 1 << UDATPG_HOUR_FIELD,
/** @internal ICU 4.4 */
UDATPG_MATCH_MINUTE_FIELD_LENGTH = 1 << UDATPG_MINUTE_FIELD,
/** @internal ICU 4.4 */
UDATPG_MATCH_SECOND_FIELD_LENGTH = 1 << UDATPG_SECOND_FIELD,
/** @draft ICU 4.4 */
/** @stable ICU 4.4 */
UDATPG_MATCH_ALL_FIELDS_LENGTH = (1 << UDATPG_FIELD_COUNT) - 1
} UDateTimePatternMatchOptions;
@ -238,9 +238,9 @@ udatpg_getBestPattern(UDateTimePatternGenerator *dtpg,
* a pointer to the UErrorCode which must not indicate a
* failure before the function call.
* @return the length of bestPattern.
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
udatpg_getBestPatternWithOptions(UDateTimePatternGenerator *dtpg,
const UChar *skeleton, int32_t length,
UDateTimePatternMatchOptions options,
@ -531,9 +531,9 @@ udatpg_replaceFieldTypes(UDateTimePatternGenerator *dtpg,
* @param pErrorCode a pointer to the UErrorCode which must not indicate a
* failure before the function call.
* @return the length of dest.
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
udatpg_replaceFieldTypesWithOptions(UDateTimePatternGenerator *dtpg,
const UChar *pattern, int32_t patternLength,
const UChar *skeleton, int32_t skeletonLength,

58
icu4c/source/i18n/unicode/uldnames.h
View file

@ -19,32 +19,32 @@
/**
* Enum used in LocaleDisplayNames::createInstance.
* @draft ICU 4.4
* @stable ICU 4.4
*/
typedef enum {
/**
* Use standard names when generating a locale name,
* e.g. en_GB displays as 'English (United Kingdom)'.
* @draft ICU 4.4
* @stable ICU 4.4
*/
ULDN_STANDARD_NAMES = 0,
/**
* Use dialect names, when generating a locale name,
* e.g. en_GB displays as 'British English'.
* @draft ICU 4.4
* @stable ICU 4.4
*/
ULDN_DIALECT_NAMES
} UDialectHandling;
/**
* Opaque C service object type for the locale display names API
* @draft ICU 4.4
* @stable ICU 4.4
*/
struct ULocaleDisplayNames;
/**
* C typedef for struct ULocaleDisplayNames.
* @draft ICU 4.4
* @stable ICU 4.4
*/
typedef struct ULocaleDisplayNames ULocaleDisplayNames;
@ -60,9 +60,9 @@ typedef struct ULocaleDisplayNames ULocaleDisplayNames;
* @param dialectHandling how to select names for locales
* @return a ULocaleDisplayNames instance
* @param pErrorCode the status code
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT ULocaleDisplayNames * U_EXPORT2
U_STABLE ULocaleDisplayNames * U_EXPORT2
uldn_open(const char * locale,
UDialectHandling dialectHandling,
UErrorCode *pErrorCode);
@ -70,9 +70,9 @@ uldn_open(const char * locale,
/**
* Closes a ULocaleDisplayNames instance obtained from uldn_open().
* @param ldn the ULocaleDisplayNames instance to be closed
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT void U_EXPORT2
U_STABLE void U_EXPORT2
uldn_close(ULocaleDisplayNames *ldn);
#if U_SHOW_CPLUSPLUS_API
@ -101,18 +101,18 @@ U_NAMESPACE_END
* not necessarily the same locale passed to {@link #uldn_open}.
* @param ldn the LocaleDisplayNames instance
* @return the display locale
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT const char * U_EXPORT2
U_STABLE const char * U_EXPORT2
uldn_getLocale(const ULocaleDisplayNames *ldn);
/**
* Returns the dialect handling used in the display names.
* @param ldn the LocaleDisplayNames instance
* @return the dialect handling enum
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT UDialectHandling U_EXPORT2
U_STABLE UDialectHandling U_EXPORT2
uldn_getDialectHandling(const ULocaleDisplayNames *ldn);
/* names for entire locales */
@ -126,9 +126,9 @@ uldn_getDialectHandling(const ULocaleDisplayNames *ldn);
* @param pErrorCode the status code
* @return the actual buffer size needed for the display name. If it's
* greater than maxResultSize, the returned name will be truncated.
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
uldn_localeDisplayName(const ULocaleDisplayNames *ldn,
const char *locale,
UChar *result,
@ -146,9 +146,9 @@ uldn_localeDisplayName(const ULocaleDisplayNames *ldn,
* @param pErrorCode the status code
* @return the actual buffer size needed for the display name. If it's
* greater than maxResultSize, the returned name will be truncated.
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
uldn_languageDisplayName(const ULocaleDisplayNames *ldn,
const char *lang,
UChar *result,
@ -164,9 +164,9 @@ uldn_languageDisplayName(const ULocaleDisplayNames *ldn,
* @param pErrorCode the status code
* @return the actual buffer size needed for the display name. If it's
* greater than maxResultSize, the returned name will be truncated.
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
uldn_scriptDisplayName(const ULocaleDisplayNames *ldn,
const char *script,
UChar *result,
@ -182,9 +182,9 @@ uldn_scriptDisplayName(const ULocaleDisplayNames *ldn,
* @param pErrorCode the status code
* @return the actual buffer size needed for the display name. If it's
* greater than maxResultSize, the returned name will be truncated.
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
uldn_scriptCodeDisplayName(const ULocaleDisplayNames *ldn,
UScriptCode scriptCode,
UChar *result,
@ -200,9 +200,9 @@ uldn_scriptCodeDisplayName(const ULocaleDisplayNames *ldn,
* @param pErrorCode the status code
* @return the actual buffer size needed for the display name. If it's
* greater than maxResultSize, the returned name will be truncated.
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
uldn_regionDisplayName(const ULocaleDisplayNames *ldn,
const char *region,
UChar *result,
@ -218,9 +218,9 @@ uldn_regionDisplayName(const ULocaleDisplayNames *ldn,
* @param pErrorCode the status code
* @return the actual buffer size needed for the display name. If it's
* greater than maxResultSize, the returned name will be truncated.
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
uldn_variantDisplayName(const ULocaleDisplayNames *ldn,
const char *variant,
UChar *result,
@ -236,9 +236,9 @@ uldn_variantDisplayName(const ULocaleDisplayNames *ldn,
* @param pErrorCode the status code
* @return the actual buffer size needed for the display name. If it's
* greater than maxResultSize, the returned name will be truncated.
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
uldn_keyDisplayName(const ULocaleDisplayNames *ldn,
const char *key,
UChar *result,
@ -255,9 +255,9 @@ uldn_keyDisplayName(const ULocaleDisplayNames *ldn,
* @param pErrorCode the status code
* @return the actual buffer size needed for the display name. If it's
* greater than maxResultSize, the returned name will be truncated.
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
uldn_keyValueDisplayName(const ULocaleDisplayNames *ldn,
const char *key,
const char *value,

10
icu4c/source/i18n/unicode/unum.h
View file

@ -160,7 +160,7 @@ typedef enum UNumberFormatStyle {
UNUM_DURATION,
/**
* Numbering system rule-based format
* @draft ICU 4.2
* @stable ICU 4.2
*/
UNUM_NUMBERING_SYSTEM,
/**
@ -396,9 +396,9 @@ unum_formatDouble( const UNumberFormat* fmt,
* @see unum_parseInt64
* @see unum_parseDouble
* @see UFieldPosition
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
unum_formatDecimal( const UNumberFormat* fmt,
const char * number,
int32_t length,
@ -533,9 +533,9 @@ unum_parseDouble( const UNumberFormat* fmt,
* @see unum_format
* @see unum_formatInt64
* @see unum_formatDouble
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
unum_parseDecimal(const UNumberFormat* fmt,
const UChar* text,
int32_t textLength,

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

@ -164,7 +164,7 @@ typedef enum {
/**
* Option to control how collation elements are compared.
* The default value will be USEARCH_STANDARD_ELEMENT_COMPARISON.
* @draft ICU 4.4
* @stable ICU 4.4
*/
USEARCH_ELEMENT_COMPARISON,
@ -185,7 +185,7 @@ typedef enum {
* Value (default) for USEARCH_ELEMENT_COMPARISON;
* standard collation element comparison at the specified collator
* strength.
* @draft ICU 4.4
* @stable ICU 4.4
*/
USEARCH_STANDARD_ELEMENT_COMPARISON,
/**
@ -199,7 +199,7 @@ typedef enum {
* the pattern will match a plain e or an e with any diacritic in the
* searched text, but an e with diacritic in the pattern will only
* match an e with the same diacritic in the searched text.
* @draft ICU 4.4
* @stable ICU 4.4
*/
USEARCH_PATTERN_BASE_WEIGHT_IS_WILDCARD,
/**
@ -213,7 +213,7 @@ typedef enum {
* in the pattern will match a plain e or an e with any diacritic in the
* searched text, but an e with diacritic in the pattern will only
* match an e with the same diacritic or a plain e in the searched text.
* @draft ICU 4.4
* @stable ICU 4.4
*/
USEARCH_ANY_BASE_WEIGHT_IS_WILDCARD,

4
icu4c/source/io/unicode/ustdio.h
View file

@ -275,9 +275,9 @@ u_finit(FILE *f,
* is NULL, in which case the system default codepage will be used.
* @return A new UFILE, or NULL if an error occurred. If an error occurs
* the ownership of the FILE* stream remains with the caller.
* @draft ICU 4.4
* @stable ICU 4.4
*/
U_DRAFT UFILE* U_EXPORT2
U_STABLE UFILE* U_EXPORT2
u_fadopt(FILE *f,
const char *locale,
const char *codepage);