AuroraMiddleware/scuffed-code
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

ICU-5008 Undraft some API

Browse Source 
X-SVN-Rev: 19003
This commit is contained in:
George Rhoten 2006-01-18 04:19:45 +00:00
parent 4ddc86def7
commit 6cacfbd7cb
17 changed files with 272 additions and 269 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
icu4c/source/i18n/unicode/dtfmtsym.h
View File

@ -1,6 +1,6 @@
/*
********************************************************************************
* Copyright (C) 1997-2005, International Business Machines
* Copyright (C) 1997-2006, International Business Machines
* Corporation and others. All Rights Reserved.
********************************************************************************
*
@ -399,7 +399,7 @@ public:
/**
* Returns the locale for this object. Two flavors are available:
* valid and actual locale.
* @draft ICU 2.8 likely to change after ICU 3.0, based on feedback
* @stable ICU 2.8
*/
Locale getLocale(ULocDataLocaleType type, UErrorCode& status) const;

26
icu4c/source/i18n/unicode/fmtable.h
View File

@ -127,7 +127,7 @@ public:
/**
* Creates a Formattable object that adopts the given UObject.
* @param objectToAdopt the UObject to set this object to
* @draft ICU 3.0
* @stable ICU 3.0
*/
Formattable(UObject* objectToAdopt);
@ -232,7 +232,7 @@ public:
/**
* Selector indicating a UObject value. Use getObject to
* retrieve the value.
* @draft ICU 3.0
* @stable ICU 3.0
*/
kObject
};
@ -248,7 +248,7 @@ public:
* Returns TRUE if the data type of this Formattable object
* is kDouble, kLong, or kInt64.
* @return TRUE if this is a pure numeric object
* @draft ICU 3.0
* @stable ICU 3.0
*/
UBool isNumeric() const;
@ -270,7 +270,7 @@ public:
* the status is set to U_INVALID_FORMAT_ERROR.
* @param status the error code
* @return the double value of this object.
* @draft ICU 3.0
* @stable ICU 3.0
*/
double getDouble(UErrorCode& status) const;
@ -296,7 +296,7 @@ public:
* the status is set to U_INVALID_FORMAT_ERROR.
* @param status the error code
* @return the long value of this object.
* @draft ICU 3.0
* @stable ICU 3.0
*/
int32_t getLong(UErrorCode& status) const;
@ -321,7 +321,7 @@ public:
* the status is set to U_INVALID_FORMAT_ERROR.
* @param status the error code
* @return the int64 value of this object.
* @draft ICU 3.0
* @stable ICU 3.0
*/
int64_t getInt64(UErrorCode& status) const;
@ -339,7 +339,7 @@ public:
* undefined.
* @param status the error code.
* @return the Date value of this object.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDate getDate(UErrorCode& status) const;
@ -360,7 +360,7 @@ public:
* @param result Output param to receive the Date value of this object.
* @param status the error code.
* @return A reference to 'result'.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UnicodeString& getString(UnicodeString& result, UErrorCode& status) const;
@ -379,7 +379,7 @@ public:
* U_INVALID_FORMAT_ERROR and the result is a bogus string.
* @param status the error code.
* @return a const reference to the string value of this object.
* @draft ICU 3.0
* @stable ICU 3.0
*/
const UnicodeString& getString(UErrorCode& status) const;
@ -397,7 +397,7 @@ public:
* and the result is a bogus string.
* @param status the error code.
* @return a reference to the string value of this object.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UnicodeString& getString(UErrorCode& status);
@ -418,7 +418,7 @@ public:
* @param count fill-in with the count of this object.
* @param status the error code.
* @return the array value of this object.
* @draft ICU 3.0
* @stable ICU 3.0
*/
const Formattable* getArray(int32_t& count, UErrorCode& status) const;
@ -436,7 +436,7 @@ public:
* Returns a pointer to the UObject contained within this
* formattable, or NULL if this object does not contain a UObject.
* @return a UObject pointer, or NULL
* @draft ICU 3.0
* @stable ICU 3.0
*/
const UObject* getObject() const;
@ -509,7 +509,7 @@ public:
* the type to kObject. After this call, the caller must not
* delete the given object.
* @param objectToAdopt the UObject value to be adopted
* @draft ICU 3.0
* @stable ICU 3.0
*/
void adoptObject(UObject* objectToAdopt);

5
icu4c/source/i18n/unicode/format.h
View File

@ -1,6 +1,7 @@
/*
********************************************************************************
* Copyright (C) {1997-2005}, International Business Machines Corporation and others. All Rights Reserved.
* Copyright (C) 1997-2006, International Business Machines Corporation and others.
* All Rights Reserved.
********************************************************************************
*
* File FORMAT.H
@ -236,7 +237,7 @@ public:
* @param type type of the locale we're looking for (valid or actual)
* @param status error code for the operation
* @return the locale
* @draft ICU 2.8 likely to change after ICU 3.0, based on feedback
* @stable ICU 2.8
*/
Locale getLocale(ULocDataLocaleType type, UErrorCode& status) const;

5
icu4c/source/i18n/unicode/gregocal.h
View File

@ -1,5 +1,6 @@
/*
* Copyright (C) {1997-2005}, International Business Machines Corporation and others. All Rights Reserved.
* Copyright (C) 1997-2006, International Business Machines Corporation and others.
* All Rights Reserved.
********************************************************************************
*
* File GREGOCAL.H
@ -398,7 +399,7 @@ public:
* @param field the time field.
* @param status error result.
* @return the minimum value that this field could have, given the current date.
* @draft ICU 3.0
* @stable ICU 3.0
*/
int32_t getActualMinimum(UCalendarDateFields field, UErrorCode &status) const;

10
icu4c/source/i18n/unicode/measfmt.h
View File

@ -1,6 +1,6 @@
/*
**********************************************************************
* Copyright (c) 2004-2005, International Business Machines
* Copyright (c) 2004-2006, International Business Machines
* Corporation and others. All Rights Reserved.
**********************************************************************
* Author: Alan Liu
@ -36,7 +36,7 @@ U_NAMESPACE_BEGIN
*
* @see Format
* @author Alan Liu
* @draft ICU 3.0
* @stable ICU 3.0
*/
class U_I18N_API MeasureFormat : public Format {
@ -48,7 +48,7 @@ class U_I18N_API MeasureFormat : public Format {
* @param locale desired locale
* @param ec input-output error code
* @return a formatter object, or NULL upon error
* @draft ICU 3.0
* @stable ICU 3.0
*/
static MeasureFormat* U_EXPORT2 createCurrencyFormat(const Locale& locale,
UErrorCode& ec);
@ -58,7 +58,7 @@ class U_I18N_API MeasureFormat : public Format {
* locale.
* @param ec input-output error code
* @return a formatter object, or NULL upon error
* @draft ICU 3.0
* @stable ICU 3.0
*/
static MeasureFormat* U_EXPORT2 createCurrencyFormat(UErrorCode& ec);
@ -66,7 +66,7 @@ class U_I18N_API MeasureFormat : public Format {
/**
* Default constructor.
* @draft ICU 3.0
* @stable ICU 3.0
*/
MeasureFormat();
};

12
icu4c/source/i18n/unicode/measunit.h
View File

@ -1,6 +1,6 @@
/*
**********************************************************************
* Copyright (c) 2004-2005, International Business Machines
* Copyright (c) 2004-2006, International Business Machines
* Corporation and others. All Rights Reserved.
**********************************************************************
* Author: Alan Liu
@ -31,34 +31,34 @@ U_NAMESPACE_BEGIN
* <p>This is an abstract class.
*
* @author Alan Liu
* @draft ICU 3.0
* @stable ICU 3.0
*/
class U_I18N_API MeasureUnit: public UObject {
public:
/**
* Return a polymorphic clone of this object. The result will
* have the same class as returned by getDynamicClassID().
* @draft ICU 3.0
* @stable ICU 3.0
*/
virtual UObject* clone() const = 0;
/**
* Destructor
* @draft ICU 3.0
* @stable ICU 3.0
*/
virtual ~MeasureUnit();
/**
* Equality operator. Return true if this object is equal
* to the given object.
* @draft ICU 3.0
* @stable ICU 3.0
*/
virtual UBool operator==(const UObject& other) const = 0;
protected:
/**
* Default constructor.
* @draft ICU 3.0
* @stable ICU 3.0
*/
MeasureUnit();
};

22
icu4c/source/i18n/unicode/measure.h
View File

@ -1,6 +1,6 @@
/*
**********************************************************************
* Copyright (c) 2004-2005, International Business Machines
* Copyright (c) 2004-2006, International Business Machines
* Corporation and others. All Rights Reserved.
**********************************************************************
* Author: Alan Liu
@ -40,7 +40,7 @@ class MeasureUnit;
* <p>This is an abstract class.
*
* @author Alan Liu
* @draft ICU 3.0
* @stable ICU 3.0
*/
class U_I18N_API Measure: public UObject {
public:
@ -52,40 +52,40 @@ class U_I18N_API Measure: public UObject {
* @param adoptedUnit the unit object, which must not be NULL
* @param ec input-output error code. If the amount or the unit
* is invalid, then this will be set to a failing value.
* @draft ICU 3.0
* @stable ICU 3.0
*/
Measure(const Formattable& number, MeasureUnit* adoptedUnit,
UErrorCode& ec);
/**
* Copy constructor
* @draft ICU 3.0
* @stable ICU 3.0
*/
Measure(const Measure& other);
/**
* Assignment operator
* @draft ICU 3.0
* @stable ICU 3.0
*/
Measure& operator=(const Measure& other);
/**
* Return a polymorphic clone of this object. The result will
* have the same class as returned by getDynamicClassID().
* @draft ICU 3.0
* @stable ICU 3.0
*/
virtual UObject* clone() const = 0;
/**
* Destructor
* @draft ICU 3.0
* @stable ICU 3.0
*/
virtual ~Measure();
/**
* Equality operator. Return true if this object is equal
* to the given object.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UBool operator==(const UObject& other) const;
@ -93,20 +93,20 @@ class U_I18N_API Measure: public UObject {
* Return a reference to the numeric value of this object. The
* numeric value may be of any numeric type supported by
* Formattable.
* @draft ICU 3.0
* @stable ICU 3.0
*/
inline const Formattable& getNumber() const;
/**
* Return a reference to the unit of this object.
* @draft ICU 3.0
* @stable ICU 3.0
*/
inline const MeasureUnit& getUnit() const;
protected:
/**
* Default constructor.
* @draft ICU 3.0
* @stable ICU 3.0
*/
Measure();

9
icu4c/source/i18n/unicode/numfmt.h
View File

@ -1,5 +1,6 @@
/*
* Copyright (C) {1997-2005}, International Business Machines Corporation and others. All Rights Reserved.
* Copyright (C) 1997-2006, International Business Machines Corporation and others.
* All Rights Reserved.
********************************************************************************
*
* File NUMFMT.H
@ -771,7 +772,7 @@ public:
/**
* Destructor
* @draft ICU 3.0
* @stable ICU 3.0
*/
virtual ~NumberFormatFactory();
@ -802,7 +803,7 @@ public:
/**
* A NumberFormatFactory that supports a single locale. It can be visible or invisible.
* @draft ICU 3.0
* @stable ICU 2.6
*/
class U_I18N_API SimpleNumberFormatFactory : public NumberFormatFactory {
protected:
@ -825,7 +826,7 @@ public:
SimpleNumberFormatFactory(const Locale& locale, UBool visible = TRUE);
/**
* @draft ICU 3.0
* @stable ICU 3.0
*/
virtual ~SimpleNumberFormatFactory();

18
icu4c/source/i18n/unicode/rbnf.h
View File

@ -1,6 +1,6 @@
/*
*******************************************************************************
* Copyright (C) 1997-2005, International Business Machines Corporation and others.
* Copyright (C) 1997-2006, International Business Machines Corporation and others.
* All Rights Reserved.
*******************************************************************************
*/
@ -517,7 +517,7 @@ public:
* syntax.
* @param perror The parse error if an error was encountered.
* @param status The status indicating whether the constructor succeeded.
* @draft ICU 3.2
* @stable ICU 3.2
*/
RuleBasedNumberFormat(const UnicodeString& rules, UParseError& perror, UErrorCode& status);
@ -542,7 +542,7 @@ public:
* names in the description. These will be copied by the constructor.
* @param perror The parse error if an error was encountered.
* @param status The status indicating whether the constructor succeeded.
* @draft ICU 3.2
* @stable ICU 3.2
*/
RuleBasedNumberFormat(const UnicodeString& rules, const UnicodeString& localizations,
UParseError& perror, UErrorCode& status);
@ -589,7 +589,7 @@ public:
* lenient parsing.
* @param perror The parse error if an error was encountered.
* @param status The status indicating whether the constructor succeeded.
* @draft ICU 3.2
* @stable ICU 3.2
*/
RuleBasedNumberFormat(const UnicodeString& rules, const UnicodeString& localizations,
const Locale& locale, UParseError& perror, UErrorCode& status);
@ -680,7 +680,7 @@ public:
/**
* Return the number of locales for which we have localized rule set display names.
* @return the number of locales for which we have localized rule set display names.
* @draft ICU 3.2
* @stable ICU 3.2
*/
virtual int32_t getNumberOfRuleSetDisplayNameLocales(void) const;
@ -690,7 +690,7 @@ public:
* @param status set to a failure code when this function fails
* @return the locale
* @see #getNumberOfRuleSetDisplayNameLocales
* @draft ICU 3.2
* @stable ICU 3.2
*/
virtual Locale getRuleSetDisplayNameLocale(int32_t index, UErrorCode& status) const;
@ -705,7 +705,7 @@ public:
* display name is desired
* @return the display name for the given index, which might be bogus if there is an error
* @see #getRuleSetName
* @draft ICU 3.2
* @stable ICU 3.2
*/
virtual UnicodeString getRuleSetDisplayName(int32_t index,
const Locale& locale = Locale::getDefault());
@ -715,7 +715,7 @@ public:
* The locale is matched against the locales for which there is display name data, using
* normal fallback rules. If no locale matches, the default display name is returned.
* @return the display name for the rule set
* @draft ICU 3.2
* @stable ICU 3.2
* @see #getRuleSetDisplayNames
*/
virtual UnicodeString getRuleSetDisplayName(const UnicodeString& ruleSetName,
@ -942,7 +942,7 @@ public:
* Return the name of the current default rule set. If the current rule set is
* not public, returns a bogus (and empty) UnicodeString.
* @return the name of the current default rule set
* @draft ICU 3.0
* @stable ICU 3.0
*/
virtual UnicodeString getDefaultRuleSetName() const;

8
icu4c/source/i18n/unicode/translit.h
View File

@ -1,6 +1,6 @@
/*
**********************************************************************
* Copyright (C) 1999-2005, International Business Machines
* Copyright (C) 1999-2006, International Business Machines
* Corporation and others. All Rights Reserved.
**********************************************************************
* Date Name Description
@ -889,7 +889,7 @@ public:
* @return the number of transliterators that compose this
* transliterator, or 1 if this transliterator is not composed of
* multiple transliterators
* @draft ICU 3.0
* @stable ICU 3.0
*/
int32_t countElements() const;
@ -910,7 +910,7 @@ public:
* transliterator, if this transliterator is made up of multiple
* transliterators, otherwise a reference to this object if given
* an index of 0
* @draft ICU 3.0
* @stable ICU 3.0
*/
const Transliterator& getElement(int32_t index, UErrorCode& ec) const;
@ -1102,7 +1102,7 @@ public:
* @return a newly-created StringEnumeration over the transliterators
* available at the time of the call. The caller should delete this object
* when done using it.
* @draft ICU 3.0
* @stable ICU 3.0
*/
static StringEnumeration* U_EXPORT2 getAvailableIDs(UErrorCode& ec);

24
icu4c/source/i18n/unicode/ucal.h
View File

@ -1,7 +1,9 @@
/*******************************************************************************
* Copyright (C) 1996-2005, International Business Machines Corporation and others. All Rights Reserved.
*******************************************************************************
*/
/*
*******************************************************************************
* Copyright (C) 1996-2006, International Business Machines Corporation and
* others. All Rights Reserved.
*******************************************************************************
*/
#ifndef UCAL_H
#define UCAL_H
@ -503,7 +505,7 @@ typedef enum UCalendarAMPMs UCalendarAMPMs;
*
* @stable ICU 2.6
*/
U_DRAFT UEnumeration* U_EXPORT2
U_STABLE UEnumeration* U_EXPORT2
ucal_openTimeZones(UErrorCode* ec);
/**
@ -522,7 +524,7 @@ ucal_openTimeZones(UErrorCode* ec);
*
* @stable ICU 2.6
*/
U_DRAFT UEnumeration* U_EXPORT2
U_STABLE UEnumeration* U_EXPORT2
ucal_openCountryTimeZones(const char* country, UErrorCode* ec);
/**
@ -541,7 +543,7 @@ ucal_openCountryTimeZones(const char* country, UErrorCode* ec);
*
* @stable ICU 2.6
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
ucal_getDefaultTimeZone(UChar* result, int32_t resultCapacity, UErrorCode* ec);
/**
@ -553,7 +555,7 @@ ucal_getDefaultTimeZone(UChar* result, int32_t resultCapacity, UErrorCode* ec);
*
* @stable ICU 2.6
*/
U_DRAFT void U_EXPORT2
U_STABLE void U_EXPORT2
ucal_setDefaultTimeZone(const UChar* zoneID, UErrorCode* ec);
/**
@ -572,7 +574,7 @@ ucal_setDefaultTimeZone(const UChar* zoneID, UErrorCode* ec);
*
* @stable ICU 2.6
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
ucal_getDSTSavings(const UChar* zoneID, UErrorCode* ec);
/**
@ -1049,9 +1051,9 @@ ucal_countAvailableTZIDs(int32_t rawOffset);
* @param type type of the locale we're looking for (valid or actual)
* @param status error code for the operation
* @return the locale name
* @draft ICU 2.8 likely to change after ICU 3.0, based on feedback
* @stable ICU 2.8
*/
U_DRAFT const char * U_EXPORT2
U_STABLE const char * U_EXPORT2
ucal_getLocaleByType(const UCalendar *cal, ULocDataLocaleType type, UErrorCode* status);
#endif /* #if !UCONFIG_NO_FORMATTING */

48
icu4c/source/i18n/unicode/ucol.h
View File

@ -1,6 +1,6 @@
/*
*******************************************************************************
* Copyright (c) 1996-2005, International Business Machines Corporation and others.
* Copyright (c) 1996-2006, International Business Machines Corporation and others.
* All Rights Reserved.
*******************************************************************************
*/
@ -319,10 +319,10 @@ ucol_openRules( const UChar *rules,
* @see ucol_setVariableTop
* @see ucol_getShortDefinitionString
* @see ucol_normalizeShortDefinitionString
* @draft ICU 3.0
* @stable ICU 3.0
*
*/
U_CAPI UCollator* U_EXPORT2
U_STABLE UCollator* U_EXPORT2
ucol_openFromShortString( const char *definition,
UBool forceDefaults,
UParseError *parseError,
@ -341,7 +341,7 @@ ucol_openFromShortString( const char *definition,
*
* @deprecated ICU 3.4, use ucol_getContractionsAndExpansions instead
*/
U_CAPI int32_t U_EXPORT2
U_DEPRECATED int32_t U_EXPORT2
ucol_getContractions( const UCollator *coll,
USet *conts,
UErrorCode *status);
@ -357,7 +357,7 @@ ucol_getContractions( const UCollator *coll,
*
* @draft ICU 3.4
*/
U_CAPI void U_EXPORT2
U_DRAFT void U_EXPORT2
ucol_getContractionsAndExpansions( const UCollator *coll,
USet *contractions, USet *expansions,
UBool addPrefixes, UErrorCode *status);
@ -546,9 +546,9 @@ ucol_countAvailable(void);
* @param status input-output error code
* @return a string enumeration over locale strings. The caller is
* responsible for closing the result.
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT UEnumeration* U_EXPORT2
U_STABLE UEnumeration* U_EXPORT2
ucol_openAvailableLocales(UErrorCode *status);
#endif
@ -559,9 +559,9 @@ ucol_openAvailableLocales(UErrorCode *status);
* @param status input-output error code
* @return a string enumeration over locale strings. The caller is
* responsible for closing the result.
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT UEnumeration* U_EXPORT2
U_STABLE UEnumeration* U_EXPORT2
ucol_getKeywords(UErrorCode *status);
/**
@ -573,9 +573,9 @@ ucol_getKeywords(UErrorCode *status);
* @param status input-output error code
* @return a string enumeration over collation keyword values, or NULL
* upon error. The caller is responsible for closing the result.
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT UEnumeration* U_EXPORT2
U_STABLE UEnumeration* U_EXPORT2
ucol_getKeywordValues(const char *keyword, UErrorCode *status);
/**
@ -606,9 +606,9 @@ ucol_getKeywordValues(const char *keyword, UErrorCode *status);
* @return the actual buffer size needed for the locale. If greater
* than resultCapacity, the returned full name will be truncated and
* an error code will be returned.
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
ucol_getFunctionalEquivalent(char* result, int32_t resultCapacity,
const char* keyword, const char* locale,
UBool* isAvailable, UErrorCode* status);
@ -643,9 +643,9 @@ ucol_getRules( const UCollator *coll,
* @return length of the resulting string
* @see ucol_openFromShortString
* @see ucol_normalizeShortDefinitionString
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_CAPI int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
ucol_getShortDefinitionString(const UCollator *coll,
const char *locale,
char *buffer,
@ -669,10 +669,10 @@ ucol_getShortDefinitionString(const UCollator *coll,
* @see ucol_openFromShortString
* @see ucol_getShortDefinitionString
*
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_CAPI int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
ucol_normalizeShortDefinitionString(const char *source,
char *destination,
int32_t capacity,
@ -808,7 +808,7 @@ ucol_getVersion(const UCollator* coll, UVersionInfo info);
* @param info the version # information, the result will be filled in
* @stable ICU 2.8
*/
U_DRAFT void U_EXPORT2
U_STABLE void U_EXPORT2
ucol_getUCAVersion(const UCollator* coll, UVersionInfo info);
/**
@ -994,9 +994,9 @@ ucol_getLocale(const UCollator *coll, ULocDataLocaleType type, UErrorCode *statu
* @return real locale name from which the collation data comes.
* If the collator was instantiated from rules, returns
* NULL.
* @draft ICU 2.8 likely to change after ICU 3.0, based on feedback
* @stable ICU 2.8
*/
U_DRAFT const char * U_EXPORT2
U_STABLE const char * U_EXPORT2
ucol_getLocaleByType(const UCollator *coll, ULocDataLocaleType type, UErrorCode *status);
/**
@ -1185,9 +1185,9 @@ ucol_prepareShortStringOpen( const char *definition,
* @param status for catching errors
* @return size of the image
* @see ucol_openBinary
* @draft ICU 3.2
* @stable ICU 3.2
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
ucol_cloneBinary(const UCollator *coll,
uint8_t *buffer, int32_t capacity,
UErrorCode *status);
@ -1207,9 +1207,9 @@ ucol_cloneBinary(const UCollator *coll,
* @param status for catching errors
* @return newly created collator
* @see ucol_cloneBinary
* @draft ICU 3.2
* @stable ICU 3.2
*/
U_DRAFT UCollator* U_EXPORT2
U_STABLE UCollator* U_EXPORT2
ucol_openBinary(const uint8_t *bin, int32_t length,
const UCollator *base,
UErrorCode *status);

30
icu4c/source/i18n/unicode/ucurr.h
View File

@ -1,6 +1,6 @@
/*
**********************************************************************
* Copyright (c) 2002-2005, International Business Machines
* Copyright (c) 2002-2006, International Business Machines
* Corporation and others. All Rights Reserved.
**********************************************************************
*/
@ -79,7 +79,7 @@ typedef enum UCurrNameStyle {
#if !UCONFIG_NO_SERVICE
/**
* @internal
* @stable ICU 2.6
*/
typedef const void* UCurrRegistryKey;
@ -145,9 +145,9 @@ ucurr_getName(const UChar* currency,
* @param ec input-output error code
* @return a non-negative number of fraction digits to be
* displayed, or 0 if there is an error
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
ucurr_getDefaultFractionDigits(const UChar* currency,
UErrorCode* ec);
@ -158,9 +158,9 @@ ucurr_getDefaultFractionDigits(const UChar* currency,
* @param ec input-output error code
* @return the non-negative rounding increment, or 0.0 if none,
* or 0.0 if there is an error
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT double U_EXPORT2
U_STABLE double U_EXPORT2
ucurr_getRoundingIncrement(const UChar* currency,
UErrorCode* ec);
@ -168,12 +168,12 @@ ucurr_getRoundingIncrement(const UChar* currency,
* Selector constants for ucurr_openCurrencies().
*
* @see ucurr_openCurrencies
* @draft ICU 3.2
* @stable ICU 3.2
*/
typedef enum UCurrCurrencyType {
/**
* Select all ISO-4217 currency codes.
* @draft ICU 3.2
* @stable ICU 3.2
*/
UCURR_ALL = INT32_MAX,
/**
@ -182,7 +182,7 @@ typedef enum UCurrCurrencyType {
* bank notes or coins associated with the currency code.
* This does not include fund codes, precious metals and other
* various ISO-4217 codes limited to special financial products.
* @draft ICU 3.2
* @stable ICU 3.2
*/
UCURR_COMMON = 1,
/**
@ -190,19 +190,19 @@ typedef enum UCurrCurrencyType {
* These codes respresent fund codes, precious metals and other
* various ISO-4217 codes limited to special financial products.
* A fund code is a monetary resource associated with a currency.
* @draft ICU 3.2
* @stable ICU 3.2
*/
UCURR_UNCOMMON = 2,
/**
* Select only deprecated ISO-4217 codes.
* These codes are no longer in general public use.
* @draft ICU 3.2
* @stable ICU 3.2
*/
UCURR_DEPRECATED = 4,
/**
* Select only non-deprecated ISO-4217 codes.
* These codes are in general public use.
* @draft ICU 3.2
* @stable ICU 3.2
*/
UCURR_NON_DEPRECATED = 8
} UCurrCurrencyType;
@ -214,9 +214,9 @@ typedef enum UCurrCurrencyType {
* currencies. Most people will want to use the (UCURR_CURRENCY|UCURR_NON_DEPRECATED) value to
* get a list of current currencies.
* @param pErrorCode Error code
* @draft ICU 3.2
* @stable ICU 3.2
*/
U_DRAFT UEnumeration * U_EXPORT2
U_STABLE UEnumeration * U_EXPORT2
ucurr_openISOCurrencies(uint32_t currType, UErrorCode *pErrorCode);
@ -244,7 +244,7 @@ U_NAMESPACE_BEGIN
*
* @internal
*/
void
U_INTERNAL void
uprv_parseCurrency(const char* locale,
const UnicodeString& text,
ParsePosition& pos,

61
icu4c/source/i18n/unicode/udat.h
View File

@ -1,6 +1,7 @@
/*
*******************************************************************************
* Copyright (C) 1996-2005, International Business Machines Corporation and others. All Rights Reserved.
* Copyright (C) 1996-2006, International Business Machines Corporation and others.
* All Rights Reserved.
*******************************************************************************
*/
@ -160,34 +161,34 @@ typedef enum UDateFormatStyle {
/**
* FieldPosition and UFieldPosition selectors for format fields
* defined by DateFormat and UDateFormat.
* @draft ICU 3.0
* @stable ICU 3.0
*/
typedef enum UDateFormatField {
/**
* FieldPosition and UFieldPosition selector for 'G' field alignment,
* corresponding to the UCAL_ERA field.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_ERA_FIELD = 0,
/**
* FieldPosition and UFieldPosition selector for 'y' field alignment,
* corresponding to the UCAL_YEAR field.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_YEAR_FIELD = 1,
/**
* FieldPosition and UFieldPosition selector for 'M' field alignment,
* corresponding to the UCAL_MONTH field.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_MONTH_FIELD = 2,
/**
* FieldPosition and UFieldPosition selector for 'd' field alignment,
* corresponding to the UCAL_DATE field.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_DATE_FIELD = 3,
@ -196,7 +197,7 @@ typedef enum UDateFormatField {
* corresponding to the UCAL_HOUR_OF_DAY field.
* UDAT_HOUR_OF_DAY1_FIELD is used for the one-based 24-hour clock.
* For example, 23:59 + 01:00 results in 24:59.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_HOUR_OF_DAY1_FIELD = 4,
@ -205,70 +206,70 @@ typedef enum UDateFormatField {
* corresponding to the UCAL_HOUR_OF_DAY field.
* UDAT_HOUR_OF_DAY0_FIELD is used for the zero-based 24-hour clock.
* For example, 23:59 + 01:00 results in 00:59.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_HOUR_OF_DAY0_FIELD = 5,
/**
* FieldPosition and UFieldPosition selector for 'm' field alignment,
* corresponding to the UCAL_MINUTE field.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_MINUTE_FIELD = 6,
/**
* FieldPosition and UFieldPosition selector for 's' field alignment,
* corresponding to the UCAL_SECOND field.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_SECOND_FIELD = 7,
/**
* FieldPosition and UFieldPosition selector for 'S' field alignment,
* corresponding to the UCAL_MILLISECOND field.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_FRACTIONAL_SECOND_FIELD = 8,
/**
* FieldPosition and UFieldPosition selector for 'E' field alignment,
* corresponding to the UCAL_DAY_OF_WEEK field.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_DAY_OF_WEEK_FIELD = 9,
/**
* FieldPosition and UFieldPosition selector for 'D' field alignment,
* corresponding to the UCAL_DAY_OF_YEAR field.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_DAY_OF_YEAR_FIELD = 10,
/**
* FieldPosition and UFieldPosition selector for 'F' field alignment,
* corresponding to the UCAL_DAY_OF_WEEK_IN_MONTH field.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_DAY_OF_WEEK_IN_MONTH_FIELD = 11,
/**
* FieldPosition and UFieldPosition selector for 'w' field alignment,
* corresponding to the UCAL_WEEK_OF_YEAR field.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_WEEK_OF_YEAR_FIELD = 12,
/**
* FieldPosition and UFieldPosition selector for 'W' field alignment,
* corresponding to the UCAL_WEEK_OF_MONTH field.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_WEEK_OF_MONTH_FIELD = 13,
/**
* FieldPosition and UFieldPosition selector for 'a' field alignment,
* corresponding to the UCAL_AM_PM field.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_AM_PM_FIELD = 14,
@ -277,7 +278,7 @@ typedef enum UDateFormatField {
* corresponding to the UCAL_HOUR field.
* UDAT_HOUR1_FIELD is used for the one-based 12-hour clock.
* For example, 11:30 PM + 1 hour results in 12:30 AM.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_HOUR1_FIELD = 15,
@ -286,7 +287,7 @@ typedef enum UDateFormatField {
* corresponding to the UCAL_HOUR field.
* UDAT_HOUR0_FIELD is used for the zero-based 12-hour clock.
* For example, 11:30 PM + 1 hour results in 00:30 AM.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_HOUR0_FIELD = 16,
@ -294,42 +295,42 @@ typedef enum UDateFormatField {
* FieldPosition and UFieldPosition selector for 'z' field alignment,
* corresponding to the UCAL_ZONE_OFFSET and
* UCAL_DST_OFFSET fields.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_TIMEZONE_FIELD = 17,
/**
* FieldPosition and UFieldPosition selector for 'Y' field alignment,
* corresponding to the UCAL_YEAR_WOY field.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_YEAR_WOY_FIELD = 18,
/**
* FieldPosition and UFieldPosition selector for 'e' field alignment,
* corresponding to the UCAL_DOW_LOCAL field.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_DOW_LOCAL_FIELD = 19,
/**
* FieldPosition and UFieldPosition selector for 'u' field alignment,
* corresponding to the UCAL_EXTENDED_YEAR field.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_EXTENDED_YEAR_FIELD = 20,
/**
* FieldPosition and UFieldPosition selector for 'g' field alignment,
* corresponding to the UCAL_JULIAN_DAY field.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_JULIAN_DAY_FIELD = 21,
/**
* FieldPosition and UFieldPosition selector for 'A' field alignment,
* corresponding to the UCAL_MILLISECONDS_IN_DAY field.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_MILLISECONDS_IN_DAY_FIELD = 22,
@ -337,7 +338,7 @@ typedef enum UDateFormatField {
* FieldPosition and UFieldPosition selector for 'Z' field alignment,
* corresponding to the UCAL_ZONE_OFFSET and
* UCAL_DST_OFFSET fields.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_TIMEZONE_RFC_FIELD = 23,
@ -369,9 +370,9 @@ typedef enum UDateFormatField {
* Valid selectors range from 0 to UDAT_FIELD_COUNT-1.
* This value is subject to change if new fields are defined
* in the future.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UDAT_FIELD_COUNT = 27
UDAT_FIELD_COUNT
} UDateFormatField;
@ -767,9 +768,9 @@ udat_setSymbols( UDateFormat *format,
* @param type type of the locale we're looking for (valid or actual)
* @param status error code for the operation
* @return the locale name
* @draft ICU 2.8 likely to change after ICU 3.0, based on feedback
* @stable ICU 2.8
*/
U_DRAFT const char* U_EXPORT2
U_STABLE const char* U_EXPORT2
udat_getLocaleByType(const UDateFormat *fmt,
ULocDataLocaleType type,
UErrorCode* status);

77
icu4c/source/i18n/unicode/unum.h
View File

@ -1,6 +1,7 @@
/*
*******************************************************************************
* Copyright (C) 1997-2006, International Business Machines Corporation and others. All Rights Reserved.
* Copyright (C) 1997-2006, International Business Machines Corporation and others.
* All Rights Reserved.
* Modification History:
*
* Date Name Description
@ -133,7 +134,7 @@ typedef void* UNumberFormat;
typedef enum UNumberFormatStyle {
/**
* Decimal format defined by pattern
* @draft ICU 3.0
* @stable ICU 3.0
*/
UNUM_PATTERN_DECIMAL=0,
/** Decimal format */
@ -148,17 +149,17 @@ typedef enum UNumberFormatStyle {
UNUM_SPELLOUT,
/**
* Ordinal rule-based format
* @draft ICU 3.0
* @stable ICU 3.0
*/
UNUM_ORDINAL,
/**
* Duration rule-based format
* @draft ICU 3.0
* @stable ICU 3.0
*/
UNUM_DURATION,
/**
* Rule-based format defined by pattern
* @draft ICU 3.0
* @stable ICU 3.0
*/
UNUM_PATTERN_RULEBASED,
/** Default format */
@ -221,7 +222,7 @@ typedef enum UNumberFormatPadPosition {
* @see DecimalFormat
* @stable ICU 2.0
*/
U_CAPI UNumberFormat* U_EXPORT2
U_STABLE UNumberFormat* U_EXPORT2
unum_open( UNumberFormatStyle style,
const UChar* pattern,
int32_t patternLength,
@ -236,7 +237,7 @@ unum_open( UNumberFormatStyle style,
* @param fmt The formatter to close.
* @stable ICU 2.0
*/
U_CAPI void U_EXPORT2
U_STABLE void U_EXPORT2
unum_close(UNumberFormat* fmt);
/**
@ -247,7 +248,7 @@ unum_close(UNumberFormat* fmt);
* @return A pointer to a UNumberFormat identical to fmt.
* @stable ICU 2.0
*/
U_CAPI UNumberFormat* U_EXPORT2
U_STABLE UNumberFormat* U_EXPORT2
unum_clone(const UNumberFormat *fmt,
UErrorCode *status);
@ -272,7 +273,7 @@ unum_clone(const UNumberFormat *fmt,
* @see UFieldPosition
* @stable ICU 2.0
*/
U_CAPI int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
unum_format( const UNumberFormat* fmt,
int32_t number,
UChar* result,
@ -301,7 +302,7 @@ unum_format( const UNumberFormat* fmt,
* @see UFieldPosition
* @stable ICU 2.0
*/
U_CAPI int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
unum_formatInt64(const UNumberFormat *fmt,
int64_t number,
UChar* result,
@ -330,7 +331,7 @@ unum_formatInt64(const UNumberFormat *fmt,
* @see UFieldPosition
* @stable ICU 2.0
*/
U_CAPI int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
unum_formatDouble( const UNumberFormat* fmt,
double number,
UChar* result,
@ -357,9 +358,9 @@ unum_formatDouble( const UNumberFormat* fmt,
* @see unum_formatDouble
* @see unum_parseDoubleCurrency
* @see UFieldPosition
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
unum_formatDoubleCurrency(const UNumberFormat* fmt,
double number,
UChar* currency,
@ -385,7 +386,7 @@ unum_formatDoubleCurrency(const UNumberFormat* fmt,
* @see unum_formatDouble
* @stable ICU 2.0
*/
U_CAPI int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
unum_parse( const UNumberFormat* fmt,
const UChar* text,
int32_t textLength,
@ -433,7 +434,7 @@ unum_parseInt64(const UNumberFormat* fmt,
* @see unum_formatDouble
* @stable ICU 2.0
*/
U_CAPI double U_EXPORT2
U_STABLE double U_EXPORT2
unum_parseDouble( const UNumberFormat* fmt,
const UChar* text,
int32_t textLength,
@ -457,9 +458,9 @@ unum_parseDouble( const UNumberFormat* fmt,
* @return the parsed double
* @see unum_parseDouble
* @see unum_formatDoubleCurrency
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT double U_EXPORT2
U_STABLE double U_EXPORT2
unum_parseDoubleCurrency(const UNumberFormat* fmt,
const UChar* text,
int32_t textLength,
@ -483,7 +484,7 @@ unum_parseDoubleCurrency(const UNumberFormat* fmt,
* @see DecimalFormat
* @stable ICU 2.0
*/
U_CAPI void U_EXPORT2
U_STABLE void U_EXPORT2
unum_applyPattern( UNumberFormat *format,
UBool localized,
const UChar *pattern,
@ -502,7 +503,7 @@ unum_applyPattern( UNumberFormat *format,
* @see unum_countAvailable
* @stable ICU 2.0
*/
U_CAPI const char* U_EXPORT2
U_STABLE const char* U_EXPORT2
unum_getAvailable(int32_t index);
/**
@ -514,7 +515,7 @@ unum_getAvailable(int32_t index);
* @see unum_getAvailable
* @stable ICU 2.0
*/
U_CAPI int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
unum_countAvailable(void);
/** The possible UNumberFormat numeric attributes @stable ICU 2.0 */
@ -552,16 +553,16 @@ typedef enum UNumberFormatAttribute {
/** Secondary grouping size */
UNUM_SECONDARY_GROUPING_SIZE,
/** Use significant digits
* @draft ICU 3.0 */
* @stable ICU 3.0 */
UNUM_SIGNIFICANT_DIGITS_USED,
/** Minimum significant digits
* @draft ICU 3.0 */
* @stable ICU 3.0 */
UNUM_MIN_SIGNIFICANT_DIGITS,
/** Maximum significant digits
* @draft ICU 3.0 */
* @stable ICU 3.0 */
UNUM_MAX_SIGNIFICANT_DIGITS,
/** Lenient parse mode used by rule-based formats.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UNUM_LENIENT_PARSE
} UNumberFormatAttribute;
@ -582,7 +583,7 @@ typedef enum UNumberFormatAttribute {
* @see unum_setTextAttribute
* @stable ICU 2.0
*/
U_CAPI int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
unum_getAttribute(const UNumberFormat* fmt,
UNumberFormatAttribute attr);
@ -605,7 +606,7 @@ unum_getAttribute(const UNumberFormat* fmt,
* @see unum_setTextAttribute
* @stable ICU 2.0
*/
U_CAPI void U_EXPORT2
U_STABLE void U_EXPORT2
unum_setAttribute( UNumberFormat* fmt,
UNumberFormatAttribute attr,
int32_t newValue);
@ -625,7 +626,7 @@ unum_setAttribute( UNumberFormat* fmt,
* @see unum_setTextAttribute
* @stable ICU 2.0
*/
U_CAPI double U_EXPORT2
U_STABLE double U_EXPORT2
unum_getDoubleAttribute(const UNumberFormat* fmt,
UNumberFormatAttribute attr);
@ -643,7 +644,7 @@ unum_getDoubleAttribute(const UNumberFormat* fmt,
* @see unum_setTextAttribute
* @stable ICU 2.0
*/
U_CAPI void U_EXPORT2
U_STABLE void U_EXPORT2
unum_setDoubleAttribute( UNumberFormat* fmt,
UNumberFormatAttribute attr,
double newValue);
@ -664,14 +665,14 @@ typedef enum UNumberFormatTextAttribute {
UNUM_CURRENCY_CODE,
/**
* The default rule set. This is only available with rule-based formatters.
* @draft ICU 3.0
* @stable ICU 3.0
*/
UNUM_DEFAULT_RULESET,
/**
* The public rule sets. This is only available with rule-based formatters.
* This is a read-only attribute. The public rulesets are returned as a
* single string, with each ruleset name delimited by ';' (semicolon).
* @draft ICU 3.0
* @stable ICU 3.0
*/
UNUM_PUBLIC_RULESETS
} UNumberFormatTextAttribute;
@ -694,7 +695,7 @@ typedef enum UNumberFormatTextAttribute {
* @see unum_setAttribute
* @stable ICU 2.0
*/
U_CAPI int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
unum_getTextAttribute( const UNumberFormat* fmt,
UNumberFormatTextAttribute tag,
UChar* result,
@ -717,7 +718,7 @@ unum_getTextAttribute( const UNumberFormat* fmt,
* @see unum_setAttribute
* @stable ICU 2.0
*/
U_CAPI void U_EXPORT2
U_STABLE void U_EXPORT2
unum_setTextAttribute( UNumberFormat* fmt,
UNumberFormatTextAttribute tag,
const UChar* newValue,
@ -740,7 +741,7 @@ unum_setTextAttribute( UNumberFormat* fmt,
* @see DecimalFormat
* @stable ICU 2.0
*/
U_CAPI int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
unum_toPattern( const UNumberFormat* fmt,
UBool isPatternLocalized,
UChar* result,
@ -788,7 +789,7 @@ typedef enum UNumberFormatSymbol {
/** Nan symbol */
UNUM_NAN_SYMBOL,
/** Significant digit symbol
* @draft ICU 3.0 */
* @stable ICU 3.0 */
UNUM_SIGNIFICANT_DIGIT_SYMBOL,
/** The monetary grouping separator
* @draft ICU 3.6
@ -814,7 +815,7 @@ typedef enum UNumberFormatSymbol {
* @see unum_setSymbol
* @stable ICU 2.0
*/
U_CAPI int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
unum_getSymbol(const UNumberFormat *fmt,
UNumberFormatSymbol symbol,
UChar *buffer,
@ -834,7 +835,7 @@ unum_getSymbol(const UNumberFormat *fmt,
* @see unum_getSymbol
* @stable ICU 2.0
*/
U_CAPI void U_EXPORT2
U_STABLE void U_EXPORT2
unum_setSymbol(UNumberFormat *fmt,
UNumberFormatSymbol symbol,
const UChar *value,
@ -849,9 +850,9 @@ unum_setSymbol(UNumberFormat *fmt,
* @param type type of the locale we're looking for (valid or actual)
* @param status error code for the operation
* @return the locale name
* @draft ICU 2.8 likely to change after ICU 3.0, based on feedback
* @stable ICU 2.8
*/
U_CAPI const char* U_EXPORT2
U_STABLE const char* U_EXPORT2
unum_getLocaleByType(const UNumberFormat *fmt,
ULocDataLocaleType type,
UErrorCode* status);

128
icu4c/source/i18n/unicode/uregex.h
View File

@ -1,6 +1,6 @@
/*
**********************************************************************
* Copyright (C) 2004-2005, International Business Machines
* Copyright (C) 2004-2006, International Business Machines
* Corporation and others. All Rights Reserved.
**********************************************************************
* file name: regex.h
@ -29,18 +29,14 @@
#include "unicode/parseerr.h"
#ifndef U_HIDE_DRAFT_API
struct URegularExpression;
/**
* Structure represeting a compiled regular rexpression, plus the results
* of a match operation.
* @draft ICU 3.0
* @stable ICU 3.0
*/
typedef struct URegularExpression URegularExpression;
#endif /* U_HIDE_DRAFT_API */
/**
* Constants for Regular Expression Match Modes.
@ -96,10 +92,10 @@ typedef enum URegexpFlag{
* error within the source regular expression string. If this
* information is not wanted, pass NULL for this parameter.
* @param status Receives error detected by this function.
* @draft ICU 3.0
* @stable ICU 3.0
*
*/
U_DRAFT URegularExpression * U_EXPORT2
U_STABLE URegularExpression * U_EXPORT2
uregex_open( const UChar *pattern,
int32_t patternLength,
uint32_t flags,
@ -127,10 +123,10 @@ uregex_open( const UChar *pattern,
* @return The URegularExpression object representing the compiled
* pattern.
*
* @draft ICU 3.0
* @stable ICU 3.0
*/
#if !UCONFIG_NO_CONVERSION
U_DRAFT URegularExpression * U_EXPORT2
U_STABLE URegularExpression * U_EXPORT2
uregex_openC( const char *pattern,
uint32_t flags,
UParseError *pe,
@ -144,9 +140,9 @@ uregex_openC( const char *pattern,
* was holding.
*
* @param regexp The regular expression to be closed.
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT void U_EXPORT2
U_STABLE void U_EXPORT2
uregex_close(URegularExpression *regexp);
/**
@ -165,9 +161,9 @@ uregex_close(URegularExpression *regexp);
* @param regexp The compiled regular expression to be cloned.
* @param status Receives indication of any errors encountered
* @return the cloned copy of the compiled regular expression.
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT URegularExpression * U_EXPORT2
U_STABLE URegularExpression * U_EXPORT2
uregex_clone(const URegularExpression *regexp, UErrorCode *status);
/**
@ -184,9 +180,9 @@ uregex_clone(const URegularExpression *regexp, UErrorCode *status);
* owned by the regular expression object, and must not be
* altered or deleted by the application. The returned string
* will remain valid until the regular expression is closed.
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT const UChar * U_EXPORT2
U_STABLE const UChar * U_EXPORT2
uregex_pattern(const URegularExpression *regexp,
int32_t *patLength,
UErrorCode *status);
@ -198,9 +194,9 @@ uregex_pattern(const URegularExpression *regexp,
* @param regexp The compiled regular expression.
* @return The match mode flags
* @see URegexpFlag
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
uregex_flags(const URegularExpression *regexp,
UErrorCode *status);
@ -223,9 +219,9 @@ uregex_flags(const URegularExpression *regexp,
* @param textLength The length of the subject text, or -1 if the string
* is NUL terminated.
* @param status Receives errors detected by this function.
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT void U_EXPORT2
U_STABLE void U_EXPORT2
uregex_setText(URegularExpression *regexp,
const UChar *text,
int32_t textLength,
@ -245,9 +241,9 @@ uregex_setText(URegularExpression *regexp,
* @param status Receives errors detected by this function.
* @return Poiner to the subject text string currently associated with
* this regular expression.
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT const UChar * U_EXPORT2
U_STABLE const UChar * U_EXPORT2
uregex_getText(URegularExpression *regexp,
int32_t *textLength,
UErrorCode *status);
@ -260,9 +256,9 @@ uregex_getText(URegularExpression *regexp,
* @param startIndex The input string index at which to begin matching.
* @param status Receives errors detected by this function.
* @return TRUE if there is a match
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT UBool U_EXPORT2
U_STABLE UBool U_EXPORT2
uregex_matches(URegularExpression *regexp,
int32_t startIndex,
UErrorCode *status);
@ -280,9 +276,9 @@ uregex_matches(URegularExpression *regexp,
* @param startIndex The input string index at which to begin matching.
* @param status A reference to a UErrorCode to receive any errors.
* @return TRUE if there is a match.
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT UBool U_EXPORT2
U_STABLE UBool U_EXPORT2
uregex_lookingAt(URegularExpression *regexp,
int32_t startIndex,
UErrorCode *status);
@ -297,9 +293,9 @@ uregex_lookingAt(URegularExpression *regexp,
* @param startIndex The position in the input string to begin the search
* @param status A reference to a UErrorCode to receive any errors.
* @return TRUE if a match is found.
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT UBool U_EXPORT2
U_STABLE UBool U_EXPORT2
uregex_find(URegularExpression *regexp,
int32_t startIndex,
UErrorCode *status);
@ -315,9 +311,9 @@ uregex_find(URegularExpression *regexp,
* @param status A reference to a UErrorCode to receive any errors.
* @return TRUE if a match is found.
* @see uregex_reset
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT UBool U_EXPORT2
U_STABLE UBool U_EXPORT2
uregex_findNext(URegularExpression *regexp,
UErrorCode *status);
@ -326,9 +322,9 @@ uregex_findNext(URegularExpression *regexp,
* @param regexp The compiled regular expression.
* @param status A reference to a UErrorCode to receive any errors.
* @return the number of capture groups
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
uregex_groupCount(URegularExpression *regexp,
UErrorCode *status);
@ -346,9 +342,9 @@ uregex_groupCount(URegularExpression *regexp,
* @param status A reference to a UErrorCode to receive any errors.
* @return Length of matching data,
* or -1 if no applicable match.
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
uregex_group(URegularExpression *regexp,
int32_t groupNum,
UChar *dest,
@ -368,9 +364,9 @@ uregex_group(URegularExpression *regexp,
* @param status A reference to a UErrorCode to receive any errors.
* @return the starting position in the input of the text matched
* by the specified group.
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
uregex_start(URegularExpression *regexp,
int32_t groupNum,
UErrorCode *status);
@ -386,9 +382,9 @@ uregex_start(URegularExpression *regexp,
* @param groupNum The capture group number
* @param status A reference to a UErrorCode to receive any errors.
* @return the index of the position following the last matched character.
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
uregex_end(URegularExpression *regexp,
int32_t groupNum,
UErrorCode *status);
@ -403,9 +399,9 @@ uregex_end(URegularExpression *regexp,
* @param index The position in the text at which a
* uregex_findNext() should begin searching.
* @param status A reference to a UErrorCode to receive any errors.
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT void U_EXPORT2
U_STABLE void U_EXPORT2
uregex_reset(URegularExpression *regexp,
int32_t index,
UErrorCode *status);
@ -432,9 +428,9 @@ uregex_reset(URegularExpression *regexp,
* and replace operation. In the event that the
* destination capacity is inadequate, the return value
* is still the full length of the untruncated string.
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
uregex_replaceAll(URegularExpression *regexp,
const UChar *replacementText,
int32_t replacementLength,
@ -465,9 +461,9 @@ uregex_replaceAll(URegularExpression *regexp,
* and replace operation. In the event that the
* destination capacity is inadequate, the return value
* is still the full length of the untruncated string.
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
uregex_replaceFirst(URegularExpression *regexp,
const UChar *replacementText,
int32_t replacementLength,
@ -519,10 +515,10 @@ uregex_replaceFirst(URegularExpression *regexp,
* destCapacity is inadequate, the full length of the
* untruncated output string is returned.
*
* @draft ICU 3.0
* @stable ICU 3.0
*
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
uregex_appendReplacement(URegularExpression *regexp,
const UChar *replacementText,
int32_t replacementLength,
@ -553,9 +549,9 @@ uregex_appendReplacement(URegularExpression *regexp,
* destCapacity is inadequate, the full length of the
* untruncated output string is returned.
*
* @draft ICU 3.0
* @stable ICU 3.0
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
uregex_appendTail(URegularExpression *regexp,
UChar **destBuf,
int32_t *destCapacity,
@ -573,6 +569,22 @@ uregex_appendTail(URegularExpression *regexp,
* Each of the fields is copied from the input string to the destination
* buffer, and the NUL terminated. The position of each field within
* the destination buffer is returned in the destFields array.
*
* Note: another choice for the design of this function would be to not
* copy the resulting fields at all, but to return indexes and
* lengths within the source text.
* Advantages would be
* o Faster. No Copying.
* o Nothing extra needed when field data may contain embedded NUL chars.
* o Less memory needed if working on large data.
* Disadvantages
* o Less consistent with C++ split, which copies into an
* array of UnicodeStrings.
* o No NUL termination, extracted fields would be less convenient
* to use in most cases.
* o Possible problems in the future, when support Unicode Normalization
* could cause the fields to not correspond exactly to
* a range of the source text.
*
* @param regexp The compiled regular expression.
* @param destBuf A (UChar *) buffer to receive the fields that
@ -600,25 +612,9 @@ uregex_appendTail(URegularExpression *regexp,
* positions are used.
* @param status A reference to a UErrorCode to receive any errors.
* @return The number of fields into which the input string was split.
* @draft ICU 3.0
*
* Note: another choice for the design of this function would be to not
* copy the resulting fields at all, but to return indexes and
* lengths within the source text.
* Advantages would be
* o Faster. No Copying.
* o Nothing extra needed when field data may contain embedded NUL chars.
* o Less memory needed if working on large data.
* Disadvantages
* o Less consistent with C++ split, which copies into an
* array of UnicodeStrings.
* o No NUL termination, extracted fields would be less convenient
* to use in most cases.
* o Possible problems in the future, when support Unicode Normalization
* could cause the fields to not correspond exactly to
* a range of the source text.
* @stable ICU 3.0
*/
U_DRAFT int32_t U_EXPORT2
U_STABLE int32_t U_EXPORT2
uregex_split( URegularExpression *regexp,
UChar *destBuf,
int32_t destCapacity,

54
icu4c/source/i18n/unicode/utmscale.h
View File

@ -1,6 +1,6 @@
/*
*******************************************************************************
* Copyright (C) 2004 - 2005, International Business Machines Corporation and
* Copyright (C) 2004 - 2006, International Business Machines Corporation and
* others. All Rights Reserved.
*******************************************************************************
*/
@ -190,14 +190,14 @@
* <code>UDateTimeScale</code> values are used to specify the time scale used for
* conversion into or out if the universal time scale.
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
typedef enum UDateTimeScale {
/**
* Used in the JDK. Data is a Java <code>long</code> (<code>int64_t</code>). Value
* is milliseconds since January 1, 1970.
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
UDTS_JAVA_TIME = 0,
@ -205,7 +205,7 @@ typedef enum UDateTimeScale {
* Used on Unix systems. Data is <code>int32_t</code> or <code>int64_t</code>. Value
* is seconds since January 1, 1970.
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
UDTS_UNIX_TIME,
@ -213,7 +213,7 @@ typedef enum UDateTimeScale {
* Used in IUC4C. Data is a <code>double</code>. Value
* is milliseconds since January 1, 1970.
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
UDTS_ICU4C_TIME,
@ -221,7 +221,7 @@ typedef enum UDateTimeScale {
* Used in Windows for file times. Data is an <code>int64_t</code>. Value
* is ticks (1 tick == 100 nanoseconds) since January 1, 1601.
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
UDTS_WINDOWS_FILE_TIME,
@ -229,7 +229,7 @@ typedef enum UDateTimeScale {
* Used in the .NET framework's <code>System.DateTime</code> structure. Data is an <code>int64_t</code>. Value
* is ticks (1 tick == 100 nanoseconds) since January 1, 0001.
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
UDTS_DOTNET_DATE_TIME,
@ -237,7 +237,7 @@ typedef enum UDateTimeScale {
* Used in older Macintosh systems. Data is an <code>int32_t</code>. Value
* is seconds since January 1, 1904.
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
UDTS_MAC_OLD_TIME,
@ -245,7 +245,7 @@ typedef enum UDateTimeScale {
* Used in newer Macintosh systems. Data is a <code>double</code>. Value
* is seconds since January 1, 2001.
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
UDTS_MAC_TIME,
@ -253,7 +253,7 @@ typedef enum UDateTimeScale {
* Used in Excel. Data is an <code>?unknown?</code>. Value
* is days since December 31, 1899.
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
UDTS_EXCEL_TIME,
@ -261,14 +261,14 @@ typedef enum UDateTimeScale {
* Used in DB2. Data is an <code>?unknown?</code>. Value
* is days since December 31, 1899.
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
UDTS_DB2_TIME,
/**
* The first unused time scale value.
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
UDTS_MAX_SCALE
} UDateTimeScale;
@ -279,7 +279,7 @@ typedef enum UDateTimeScale {
*
* @see utmscale_getTimeScaleValue
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
typedef enum UTimeScaleValue {
/**
@ -288,7 +288,7 @@ typedef enum UTimeScaleValue {
*
* @see utmscale_getTimeScaleValue
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
UTSV_UNITS_VALUE = 0,
@ -298,7 +298,7 @@ typedef enum UTimeScaleValue {
*
* @see utmscale_getTimeScaleValue
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
UTSV_EPOCH_OFFSET_VALUE,
@ -308,7 +308,7 @@ typedef enum UTimeScaleValue {
*
* @see utmscale_getTimeScaleValue
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
UTSV_FROM_MIN_VALUE,
@ -318,7 +318,7 @@ typedef enum UTimeScaleValue {
*
* @see utmscale_getTimeScaleValue
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
UTSV_FROM_MAX_VALUE,
@ -328,7 +328,7 @@ typedef enum UTimeScaleValue {
*
* @see utmscale_getTimeScaleValue
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
UTSV_TO_MIN_VALUE,
@ -338,7 +338,7 @@ typedef enum UTimeScaleValue {
*
* @see utmscale_getTimeScaleValue
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
UTSV_TO_MAX_VALUE,
@ -351,7 +351,7 @@ typedef enum UTimeScaleValue {
*
* @see utmscale_getTimeScaleValue
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
UTSV_EPOCH_OFFSET_PLUS_1_VALUE,
@ -364,7 +364,7 @@ typedef enum UTimeScaleValue {
*
* @see utmscale_getTimeScaleValue
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
UTSV_EPOCH_OFFSET_MINUS_1_VALUE,
@ -424,9 +424,9 @@ typedef enum UTimeScaleValue {
* @param status The status code. Set to <code>U_ILLEGAL_ARGUMENT_ERROR</code> if arguments are invalid.
* @return - the value.
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
U_DRAFT int64_t U_EXPORT2
U_STABLE int64_t U_EXPORT2
utmscale_getTimeScaleValue(UDateTimeScale timeScale, UTimeScaleValue value, UErrorCode *status);
/* Conversion to 'universal time scale' */
@ -440,9 +440,9 @@ U_DRAFT int64_t U_EXPORT2
*
* @return The datetime converted to the universal time scale
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
U_DRAFT int64_t U_EXPORT2
U_STABLE int64_t U_EXPORT2
utmscale_fromInt64(int64_t otherTime, UDateTimeScale timeScale, UErrorCode *status);
/* Conversion from 'universal time scale' */
@ -456,9 +456,9 @@ U_DRAFT int64_t U_EXPORT2
*
* @return The datetime converted to the given time scale
*
* @draft ICU 3.2
* @stable ICU 3.2
*/
U_DRAFT int64_t U_EXPORT2
U_STABLE int64_t U_EXPORT2
utmscale_toInt64(int64_t universalTime, UDateTimeScale timeScale, UErrorCode *status);
#endif /* #if !UCONFIG_NO_FORMATTING */