Index: icu46/source/i18n/unicode/dtfmtsym.h |
=================================================================== |
--- icu46/source/i18n/unicode/dtfmtsym.h (revision 0) |
+++ icu46/source/i18n/unicode/dtfmtsym.h (revision 0) |
@@ -0,0 +1,755 @@ |
+/* |
+******************************************************************************** |
+* Copyright (C) 1997-2010, International Business Machines |
+* Corporation and others. All Rights Reserved. |
+******************************************************************************** |
+* |
+* File DTFMTSYM.H |
+* |
+* Modification History: |
+* |
+* Date Name Description |
+* 02/19/97 aliu Converted from java. |
+* 07/21/98 stephen Added getZoneIndex() |
+* Changed to match C++ conventions |
+******************************************************************************** |
+*/ |
+ |
+#ifndef DTFMTSYM_H |
+#define DTFMTSYM_H |
+ |
+#include "unicode/utypes.h" |
+ |
+#if !UCONFIG_NO_FORMATTING |
+ |
+#include "unicode/calendar.h" |
+#include "unicode/uobject.h" |
+#include "unicode/locid.h" |
+#include "unicode/ures.h" |
+ |
+/** |
+ * \file |
+ * \brief C++ API: Symbols for formatting dates. |
+ */ |
+ |
+U_NAMESPACE_BEGIN |
+ |
+/* forward declaration */ |
+class SimpleDateFormat; |
+class Hashtable; |
+class ZoneStringFormat; |
+class SafeZoneStringFormatPtr; |
+ |
+/** |
+ * DateFormatSymbols is a public class for encapsulating localizable date-time |
+ * formatting data -- including timezone data. DateFormatSymbols is used by |
+ * DateFormat and SimpleDateFormat. |
+ * <P> |
+ * Rather than first creating a DateFormatSymbols to get a date-time formatter |
+ * by using a SimpleDateFormat constructor, clients are encouraged to create a |
+ * date-time formatter using the getTimeInstance(), getDateInstance(), or |
+ * getDateTimeInstance() method in DateFormat. Each of these methods can return a |
+ * date/time formatter initialized with a default format pattern along with the |
+ * date-time formatting data for a given or default locale. After a formatter is |
+ * created, clients may modify the format pattern using the setPattern function |
+ * as so desired. For more information on using these formatter factory |
+ * functions, see DateFormat. |
+ * <P> |
+ * If clients decide to create a date-time formatter with a particular format |
+ * pattern and locale, they can do so with new SimpleDateFormat(aPattern, |
+ * new DateFormatSymbols(aLocale)). This will load the appropriate date-time |
+ * formatting data from the locale. |
+ * <P> |
+ * DateFormatSymbols objects are clonable. When clients obtain a |
+ * DateFormatSymbols object, they can feel free to modify the date-time |
+ * formatting data as necessary. For instance, clients can |
+ * replace the localized date-time format pattern characters with the ones that |
+ * they feel easy to remember. Or they can change the representative cities |
+ * originally picked by default to using their favorite ones. |
+ * <P> |
+ * DateFormatSymbols are not expected to be subclassed. Data for a calendar is |
+ * loaded out of resource bundles. The 'type' parameter indicates the type of |
+ * calendar, for example, "gregorian" or "japanese". If the type is not gregorian |
+ * (or NULL, or an empty string) then the type is appended to the resource name, |
+ * for example, 'Eras_japanese' instead of 'Eras'. If the resource 'Eras_japanese' did |
+ * not exist (even in root), then this class will fall back to just 'Eras', that is, |
+ * Gregorian data. Therefore, the calendar implementor MUST ensure that the root |
+ * locale at least contains any resources that are to be particularized for the |
+ * calendar type. |
+ */ |
+class U_I18N_API DateFormatSymbols : public UObject { |
+public: |
+ /** |
+ * Construct a DateFormatSymbols object by loading format data from |
+ * resources for the default locale, in the default calendar (Gregorian). |
+ * <P> |
+ * NOTE: This constructor will never fail; if it cannot get resource |
+ * data for the default locale, it will return a last-resort object |
+ * based on hard-coded strings. |
+ * |
+ * @param status Status code. Failure |
+ * results if the resources for the default cannot be |
+ * found or cannot be loaded |
+ * @stable ICU 2.0 |
+ */ |
+ DateFormatSymbols(UErrorCode& status); |
+ |
+ /** |
+ * Construct a DateFormatSymbols object by loading format data from |
+ * resources for the given locale, in the default calendar (Gregorian). |
+ * |
+ * @param locale Locale to load format data from. |
+ * @param status Status code. Failure |
+ * results if the resources for the locale cannot be |
+ * found or cannot be loaded |
+ * @stable ICU 2.0 |
+ */ |
+ DateFormatSymbols(const Locale& locale, |
+ UErrorCode& status); |
+ |
+ /** |
+ * Construct a DateFormatSymbols object by loading format data from |
+ * resources for the default locale, in the default calendar (Gregorian). |
+ * <P> |
+ * NOTE: This constructor will never fail; if it cannot get resource |
+ * data for the default locale, it will return a last-resort object |
+ * based on hard-coded strings. |
+ * |
+ * @param type Type of calendar (as returned by Calendar::getType). |
+ * Will be used to access the correct set of strings. |
+ * (NULL or empty string defaults to "gregorian".) |
+ * @param status Status code. Failure |
+ * results if the resources for the default cannot be |
+ * found or cannot be loaded |
+ * @internal |
+ */ |
+ DateFormatSymbols(const char *type, UErrorCode& status); |
+ |
+ /** |
+ * Construct a DateFormatSymbols object by loading format data from |
+ * resources for the given locale, in the default calendar (Gregorian). |
+ * |
+ * @param locale Locale to load format data from. |
+ * @param type Type of calendar (as returned by Calendar::getType). |
+ * Will be used to access the correct set of strings. |
+ * (NULL or empty string defaults to "gregorian".) |
+ * @param status Status code. Failure |
+ * results if the resources for the locale cannot be |
+ * found or cannot be loaded |
+ * @internal |
+ */ |
+ DateFormatSymbols(const Locale& locale, |
+ const char *type, |
+ UErrorCode& status); |
+ |
+ /** |
+ * Copy constructor. |
+ * @stable ICU 2.0 |
+ */ |
+ DateFormatSymbols(const DateFormatSymbols&); |
+ |
+ /** |
+ * Assignment operator. |
+ * @stable ICU 2.0 |
+ */ |
+ DateFormatSymbols& operator=(const DateFormatSymbols&); |
+ |
+ /** |
+ * Destructor. This is nonvirtual because this class is not designed to be |
+ * subclassed. |
+ * @stable ICU 2.0 |
+ */ |
+ virtual ~DateFormatSymbols(); |
+ |
+ /** |
+ * Return true if another object is semantically equal to this one. |
+ * |
+ * @param other the DateFormatSymbols object to be compared with. |
+ * @return true if other is semantically equal to this. |
+ * @stable ICU 2.0 |
+ */ |
+ UBool operator==(const DateFormatSymbols& other) const; |
+ |
+ /** |
+ * Return true if another object is semantically unequal to this one. |
+ * |
+ * @param other the DateFormatSymbols object to be compared with. |
+ * @return true if other is semantically unequal to this. |
+ * @stable ICU 2.0 |
+ */ |
+ UBool operator!=(const DateFormatSymbols& other) const { return !operator==(other); } |
+ |
+ /** |
+ * Gets abbreviated era strings. For example: "AD" and "BC". |
+ * |
+ * @param count Filled in with length of the array. |
+ * @return the era strings. |
+ * @stable ICU 2.0 |
+ */ |
+ const UnicodeString* getEras(int32_t& count) const; |
+ |
+ /** |
+ * Sets abbreviated era strings. For example: "AD" and "BC". |
+ * @param eras Array of era strings (DateFormatSymbols retains ownership.) |
+ * @param count Filled in with length of the array. |
+ * @stable ICU 2.0 |
+ */ |
+ void setEras(const UnicodeString* eras, int32_t count); |
+ |
+ /** |
+ * Gets era name strings. For example: "Anno Domini" and "Before Christ". |
+ * |
+ * @param count Filled in with length of the array. |
+ * @return the era name strings. |
+ * @stable ICU 3.4 |
+ */ |
+ const UnicodeString* getEraNames(int32_t& count) const; |
+ |
+ /** |
+ * Sets era name strings. For example: "Anno Domini" and "Before Christ". |
+ * @param eraNames Array of era name strings (DateFormatSymbols retains ownership.) |
+ * @param count Filled in with length of the array. |
+ * @stable ICU 3.6 |
+ */ |
+ void setEraNames(const UnicodeString* eraNames, int32_t count); |
+ |
+ /** |
+ * Gets narrow era strings. For example: "A" and "B". |
+ * |
+ * @param count Filled in with length of the array. |
+ * @return the narrow era strings. |
+ * @stable ICU 4.2 |
+ */ |
+ const UnicodeString* getNarrowEras(int32_t& count) const; |
+ |
+ /** |
+ * Sets narrow era strings. For example: "A" and "B". |
+ * @param narrowEras Array of narrow era strings (DateFormatSymbols retains ownership.) |
+ * @param count Filled in with length of the array. |
+ * @stable ICU 4.2 |
+ */ |
+ void setNarrowEras(const UnicodeString* narrowEras, int32_t count); |
+ |
+ /** |
+ * Gets month strings. For example: "January", "February", etc. |
+ * @param count Filled in with length of the array. |
+ * @return the month strings. (DateFormatSymbols retains ownership.) |
+ * @stable ICU 2.0 |
+ */ |
+ const UnicodeString* getMonths(int32_t& count) const; |
+ |
+ /** |
+ * Sets month strings. For example: "January", "February", etc. |
+ * |
+ * @param months the new month strings. (not adopted; caller retains ownership) |
+ * @param count Filled in with length of the array. |
+ * @stable ICU 2.0 |
+ */ |
+ void setMonths(const UnicodeString* months, int32_t count); |
+ |
+ /** |
+ * Gets short month strings. For example: "Jan", "Feb", etc. |
+ * |
+ * @param count Filled in with length of the array. |
+ * @return the short month strings. (DateFormatSymbols retains ownership.) |
+ * @stable ICU 2.0 |
+ */ |
+ const UnicodeString* getShortMonths(int32_t& count) const; |
+ |
+ /** |
+ * Sets short month strings. For example: "Jan", "Feb", etc. |
+ * @param count Filled in with length of the array. |
+ * @param shortMonths the new short month strings. (not adopted; caller retains ownership) |
+ * @stable ICU 2.0 |
+ */ |
+ void setShortMonths(const UnicodeString* shortMonths, int32_t count); |
+ |
+ /** |
+ * Selector for date formatting context |
+ * @stable ICU 3.6 |
+ */ |
+ enum DtContextType { |
+ FORMAT, |
+ STANDALONE, |
+ DT_CONTEXT_COUNT |
+ }; |
+ |
+ /** |
+ * Selector for date formatting width |
+ * @stable ICU 3.6 |
+ */ |
+ enum DtWidthType { |
+ ABBREVIATED, |
+ WIDE, |
+ NARROW, |
+ DT_WIDTH_COUNT |
+ }; |
+ |
+ /** |
+ * Gets month strings by width and context. For example: "January", "February", etc. |
+ * @param count Filled in with length of the array. |
+ * @param context The formatting context, either FORMAT or STANDALONE |
+ * @param width The width of returned strings, either WIDE, ABBREVIATED, or NARROW. |
+ * @return the month strings. (DateFormatSymbols retains ownership.) |
+ * @stable ICU 3.4 |
+ */ |
+ const UnicodeString* getMonths(int32_t& count, DtContextType context, DtWidthType width) const; |
+ |
+ /** |
+ * Sets month strings by width and context. For example: "January", "February", etc. |
+ * |
+ * @param months The new month strings. (not adopted; caller retains ownership) |
+ * @param count Filled in with length of the array. |
+ * @param context The formatting context, either FORMAT or STANDALONE |
+ * @param width The width of returned strings, either WIDE, ABBREVIATED, or NARROW. |
+ * @stable ICU 3.6 |
+ */ |
+ void setMonths(const UnicodeString* months, int32_t count, DtContextType context, DtWidthType width); |
+ |
+ /** |
+ * Gets weekday strings. For example: "Sunday", "Monday", etc. |
+ * @param count Filled in with length of the array. |
+ * @return the weekday strings. (DateFormatSymbols retains ownership.) |
+ * @stable ICU 2.0 |
+ */ |
+ const UnicodeString* getWeekdays(int32_t& count) const; |
+ |
+ |
+ /** |
+ * Sets weekday strings. For example: "Sunday", "Monday", etc. |
+ * @param weekdays the new weekday strings. (not adopted; caller retains ownership) |
+ * @param count Filled in with length of the array. |
+ * @stable ICU 2.0 |
+ */ |
+ void setWeekdays(const UnicodeString* weekdays, int32_t count); |
+ |
+ /** |
+ * Gets short weekday strings. For example: "Sun", "Mon", etc. |
+ * @param count Filled in with length of the array. |
+ * @return the short weekday strings. (DateFormatSymbols retains ownership.) |
+ * @stable ICU 2.0 |
+ */ |
+ const UnicodeString* getShortWeekdays(int32_t& count) const; |
+ |
+ /** |
+ * Sets short weekday strings. For example: "Sun", "Mon", etc. |
+ * @param shortWeekdays the new short weekday strings. (not adopted; caller retains ownership) |
+ * @param count Filled in with length of the array. |
+ * @stable ICU 2.0 |
+ */ |
+ void setShortWeekdays(const UnicodeString* shortWeekdays, int32_t count); |
+ |
+ /** |
+ * Gets weekday strings by width and context. For example: "Sunday", "Monday", etc. |
+ * @param count Filled in with length of the array. |
+ * @param context The formatting context, either FORMAT or STANDALONE |
+ * @param width The width of returned strings, either WIDE, ABBREVIATED, or NARROW |
+ * @return the month strings. (DateFormatSymbols retains ownership.) |
+ * @stable ICU 3.4 |
+ */ |
+ const UnicodeString* getWeekdays(int32_t& count, DtContextType context, DtWidthType width) const; |
+ |
+ /** |
+ * Sets weekday strings by width and context. For example: "Sunday", "Monday", etc. |
+ * @param weekdays The new weekday strings. (not adopted; caller retains ownership) |
+ * @param count Filled in with length of the array. |
+ * @param context The formatting context, either FORMAT or STANDALONE |
+ * @param width The width of returned strings, either WIDE, ABBREVIATED, or NARROW |
+ * @stable ICU 3.6 |
+ */ |
+ void setWeekdays(const UnicodeString* weekdays, int32_t count, DtContextType context, DtWidthType width); |
+ |
+ /** |
+ * Gets quarter strings by width and context. For example: "1st Quarter", "2nd Quarter", etc. |
+ * @param count Filled in with length of the array. |
+ * @param context The formatting context, either FORMAT or STANDALONE |
+ * @param width The width of returned strings, either WIDE or ABBREVIATED. There |
+ * are no NARROW quarters. |
+ * @return the quarter strings. (DateFormatSymbols retains ownership.) |
+ * @stable ICU 3.6 |
+ */ |
+ const UnicodeString* getQuarters(int32_t& count, DtContextType context, DtWidthType width) const; |
+ |
+ /** |
+ * Sets quarter strings by width and context. For example: "1st Quarter", "2nd Quarter", etc. |
+ * |
+ * @param quarters The new quarter strings. (not adopted; caller retains ownership) |
+ * @param count Filled in with length of the array. |
+ * @param context The formatting context, either FORMAT or STANDALONE |
+ * @param width The width of returned strings, either WIDE or ABBREVIATED. There |
+ * are no NARROW quarters. |
+ * @stable ICU 3.6 |
+ */ |
+ void setQuarters(const UnicodeString* quarters, int32_t count, DtContextType context, DtWidthType width); |
+ |
+ /** |
+ * Gets AM/PM strings. For example: "AM" and "PM". |
+ * @param count Filled in with length of the array. |
+ * @return the weekday strings. (DateFormatSymbols retains ownership.) |
+ * @stable ICU 2.0 |
+ */ |
+ const UnicodeString* getAmPmStrings(int32_t& count) const; |
+ |
+ /** |
+ * Sets ampm strings. For example: "AM" and "PM". |
+ * @param ampms the new ampm strings. (not adopted; caller retains ownership) |
+ * @param count Filled in with length of the array. |
+ * @stable ICU 2.0 |
+ */ |
+ void setAmPmStrings(const UnicodeString* ampms, int32_t count); |
+ |
+ /** |
+ * Gets timezone strings. These strings are stored in a 2-dimensional array. |
+ * @param rowCount Output param to receive number of rows. |
+ * @param columnCount Output param to receive number of columns. |
+ * @return The timezone strings as a 2-d array. (DateFormatSymbols retains ownership.) |
+ * @deprecated ICU 3.6 |
+ */ |
+ const UnicodeString** getZoneStrings(int32_t& rowCount, int32_t& columnCount) const; |
+ |
+ /** |
+ * Sets timezone strings. These strings are stored in a 2-dimensional array. |
+ * @param strings The timezone strings as a 2-d array to be copied. (not adopted; caller retains ownership) |
+ * @param rowCount The number of rows (count of first index). |
+ * @param columnCount The number of columns (count of second index). |
+ * @stable ICU 2.0 |
+ */ |
+ void setZoneStrings(const UnicodeString* const* strings, int32_t rowCount, int32_t columnCount); |
+ |
+ /** |
+ * Get the non-localized date-time pattern characters. |
+ * @return the non-localized date-time pattern characters |
+ * @stable ICU 2.0 |
+ */ |
+ static const UChar * U_EXPORT2 getPatternUChars(void); |
+ |
+ /** |
+ * Gets localized date-time pattern characters. For example: 'u', 't', etc. |
+ * <p> |
+ * Note: ICU no longer provides localized date-time pattern characters for a locale |
+ * starting ICU 3.8. This method returns the non-localized date-time pattern |
+ * characters unless user defined localized data is set by setLocalPatternChars. |
+ * @param result Output param which will receive the localized date-time pattern characters. |
+ * @return A reference to 'result'. |
+ * @stable ICU 2.0 |
+ */ |
+ UnicodeString& getLocalPatternChars(UnicodeString& result) const; |
+ |
+ /** |
+ * Sets localized date-time pattern characters. For example: 'u', 't', etc. |
+ * @param newLocalPatternChars the new localized date-time |
+ * pattern characters. |
+ * @stable ICU 2.0 |
+ */ |
+ void setLocalPatternChars(const UnicodeString& newLocalPatternChars); |
+ |
+ /** |
+ * Returns the locale for this object. Two flavors are available: |
+ * valid and actual locale. |
+ * @stable ICU 2.8 |
+ */ |
+ Locale getLocale(ULocDataLocaleType type, UErrorCode& status) const; |
+ |
+ /** |
+ * ICU "poor man's RTTI", returns a UClassID for the actual class. |
+ * |
+ * @stable ICU 2.2 |
+ */ |
+ virtual UClassID getDynamicClassID() const; |
+ |
+ /** |
+ * ICU "poor man's RTTI", returns a UClassID for this class. |
+ * |
+ * @stable ICU 2.2 |
+ */ |
+ static UClassID U_EXPORT2 getStaticClassID(); |
+ |
+private: |
+ |
+ friend class SimpleDateFormat; |
+ friend class DateFormatSymbolsSingleSetter; // see udat.cpp |
+ |
+ /** |
+ * Abbreviated era strings. For example: "AD" and "BC". |
+ */ |
+ UnicodeString* fEras; |
+ int32_t fErasCount; |
+ |
+ /** |
+ * Era name strings. For example: "Anno Domini" and "Before Christ". |
+ */ |
+ UnicodeString* fEraNames; |
+ int32_t fEraNamesCount; |
+ |
+ /** |
+ * Narrow era strings. For example: "A" and "B". |
+ */ |
+ UnicodeString* fNarrowEras; |
+ int32_t fNarrowErasCount; |
+ |
+ /** |
+ * Month strings. For example: "January", "February", etc. |
+ */ |
+ UnicodeString* fMonths; |
+ int32_t fMonthsCount; |
+ |
+ /** |
+ * Short month strings. For example: "Jan", "Feb", etc. |
+ */ |
+ UnicodeString* fShortMonths; |
+ int32_t fShortMonthsCount; |
+ |
+ /** |
+ * Narrow month strings. For example: "J", "F", etc. |
+ */ |
+ UnicodeString* fNarrowMonths; |
+ int32_t fNarrowMonthsCount; |
+ |
+ /** |
+ * Standalone Month strings. For example: "January", "February", etc. |
+ */ |
+ UnicodeString* fStandaloneMonths; |
+ int32_t fStandaloneMonthsCount; |
+ |
+ /** |
+ * Standalone Short month strings. For example: "Jan", "Feb", etc. |
+ */ |
+ UnicodeString* fStandaloneShortMonths; |
+ int32_t fStandaloneShortMonthsCount; |
+ |
+ /** |
+ * Standalone Narrow month strings. For example: "J", "F", etc. |
+ */ |
+ UnicodeString* fStandaloneNarrowMonths; |
+ int32_t fStandaloneNarrowMonthsCount; |
+ |
+ /** |
+ * Weekday strings. For example: "Sunday", "Monday", etc. |
+ */ |
+ UnicodeString* fWeekdays; |
+ int32_t fWeekdaysCount; |
+ |
+ /** |
+ * Short weekday strings. For example: "Sun", "Mon", etc. |
+ */ |
+ UnicodeString* fShortWeekdays; |
+ int32_t fShortWeekdaysCount; |
+ |
+ /** |
+ * Narrow weekday strings. For example: "Sun", "Mon", etc. |
+ */ |
+ UnicodeString* fNarrowWeekdays; |
+ int32_t fNarrowWeekdaysCount; |
+ |
+ /** |
+ * Standalone Weekday strings. For example: "Sunday", "Monday", etc. |
+ */ |
+ UnicodeString* fStandaloneWeekdays; |
+ int32_t fStandaloneWeekdaysCount; |
+ |
+ /** |
+ * Standalone Short weekday strings. For example: "Sun", "Mon", etc. |
+ */ |
+ UnicodeString* fStandaloneShortWeekdays; |
+ int32_t fStandaloneShortWeekdaysCount; |
+ |
+ /** |
+ * Standalone Narrow weekday strings. For example: "Sun", "Mon", etc. |
+ */ |
+ UnicodeString* fStandaloneNarrowWeekdays; |
+ int32_t fStandaloneNarrowWeekdaysCount; |
+ |
+ /** |
+ * Ampm strings. For example: "AM" and "PM". |
+ */ |
+ UnicodeString* fAmPms; |
+ int32_t fAmPmsCount; |
+ |
+ /** |
+ * Quarter strings. For example: "1st quarter", "2nd quarter", etc. |
+ */ |
+ UnicodeString *fQuarters; |
+ int32_t fQuartersCount; |
+ |
+ /** |
+ * Short quarters. For example: "Q1", "Q2", etc. |
+ */ |
+ UnicodeString *fShortQuarters; |
+ int32_t fShortQuartersCount; |
+ |
+ /** |
+ * Standalone quarter strings. For example: "1st quarter", "2nd quarter", etc. |
+ */ |
+ UnicodeString *fStandaloneQuarters; |
+ int32_t fStandaloneQuartersCount; |
+ |
+ /** |
+ * Standalone short quarter strings. For example: "Q1", "Q2", etc. |
+ */ |
+ UnicodeString *fStandaloneShortQuarters; |
+ int32_t fStandaloneShortQuartersCount; |
+ |
+ /** |
+ * Localized names of time zones in this locale. This is a |
+ * two-dimensional array of strings of size n by m, |
+ * where m is at least 5 and up to 7. Each of the n rows is an |
+ * entry containing the localized names for a single TimeZone. |
+ * |
+ * Each such row contains (with i ranging from 0..n-1): |
+ * |
+ * zoneStrings[i][0] - time zone ID |
+ * example: America/Los_Angeles |
+ * zoneStrings[i][1] - long name of zone in standard time |
+ * example: Pacific Standard Time |
+ * zoneStrings[i][2] - short name of zone in standard time |
+ * example: PST |
+ * zoneStrings[i][3] - long name of zone in daylight savings time |
+ * example: Pacific Daylight Time |
+ * zoneStrings[i][4] - short name of zone in daylight savings time |
+ * example: PDT |
+ * zoneStrings[i][5] - location name of zone |
+ * example: United States (Los Angeles) |
+ * zoneStrings[i][6] - long generic name of zone |
+ * example: Pacific Time |
+ * zoneStrings[i][7] - short generic of zone |
+ * example: PT |
+ * |
+ * The zone ID is not localized; it corresponds to the ID |
+ * value associated with a system time zone object. All other entries |
+ * are localized names. If a zone does not implement daylight savings |
+ * time, the daylight savings time names are ignored. |
+ * |
+ * Note:CLDR 1.5 introduced metazone and its historical mappings. |
+ * This simple two-dimensional array is no longer sufficient to represent |
+ * localized names and its historic changes. Since ICU 3.8.1, localized |
+ * zone names extracted from ICU locale data is stored in a ZoneStringFormat |
+ * instance. But we still need to support the old way of customizing |
+ * localized zone names, so we keep this field for the purpose. |
+ */ |
+ UnicodeString **fZoneStrings; // Zone string array set by setZoneStrings |
+ UnicodeString **fLocaleZoneStrings; // Zone string array created by the locale |
+ int32_t fZoneStringsRowCount; |
+ int32_t fZoneStringsColCount; |
+ |
+ const ZoneStringFormat *fZoneStringFormat; |
+ ZoneStringFormat *fZSFLocal; // Local ZoneStringFormat instance |
+ SafeZoneStringFormatPtr *fZSFCachePtr; // Cached ZoneStringFormat |
+ Locale fZSFLocale; // Locale used for getting ZoneStringFormat |
+ |
+ /** |
+ * Pattern string used for localized time zone GMT format. For example, "GMT{0}" |
+ */ |
+ UnicodeString fGmtFormat; |
+ |
+ /** |
+ * Pattern strings used for formatting zone offset in a localized time zone GMT string. |
+ */ |
+ UnicodeString *fGmtHourFormats; |
+ int32_t fGmtHourFormatsCount; |
+ |
+ enum GMTHourType { |
+ GMT_NEGATIVE_HMS = 0, |
+ GMT_NEGATIVE_HM, |
+ GMT_POSITIVE_HMS, |
+ GMT_POSITIVE_HM, |
+ GMT_HOUR_COUNT |
+ }; |
+ |
+ /** |
+ * Localized date-time pattern characters. For example: use 'u' as 'y'. |
+ */ |
+ UnicodeString fLocalPatternChars; |
+ |
+private: |
+ /** valid/actual locale information |
+ * these are always ICU locales, so the length should not be a problem |
+ */ |
+ char validLocale[ULOC_FULLNAME_CAPACITY]; |
+ char actualLocale[ULOC_FULLNAME_CAPACITY]; |
+ |
+ DateFormatSymbols(); // default constructor not implemented |
+ |
+ /** |
+ * Called by the constructors to actually load data from the resources |
+ * |
+ * @param locale The locale to get symbols for. |
+ * @param type Calendar Type (as from Calendar::getType()) |
+ * @param status Input/output parameter, set to success or |
+ * failure code upon return. |
+ * @param useLastResortData determine if use last resort data |
+ */ |
+ void initializeData(const Locale&, const char *type, UErrorCode& status, UBool useLastResortData = FALSE); |
+ |
+ /** |
+ * Copy or alias an array in another object, as appropriate. |
+ * |
+ * @param dstArray the copy destination array. |
+ * @param dstCount fill in with the lenth of 'dstArray'. |
+ * @param srcArray the source array to be copied. |
+ * @param srcCount the length of items to be copied from the 'srcArray'. |
+ */ |
+ static void assignArray(UnicodeString*& dstArray, |
+ int32_t& dstCount, |
+ const UnicodeString* srcArray, |
+ int32_t srcCount); |
+ |
+ /** |
+ * Return true if the given arrays' contents are equal, or if the arrays are |
+ * identical (pointers are equal). |
+ * |
+ * @param array1 one array to be compared with. |
+ * @param array2 another array to be compared with. |
+ * @param count the length of items to be copied. |
+ * @return true if the given arrays' contents are equal, or if the arrays are |
+ * identical (pointers are equal). |
+ */ |
+ static UBool arrayCompare(const UnicodeString* array1, |
+ const UnicodeString* array2, |
+ int32_t count); |
+ |
+ /** |
+ * Create a copy, in fZoneStrings, of the given zone strings array. The |
+ * member variables fZoneStringsRowCount and fZoneStringsColCount should be |
+ * set already by the caller. |
+ */ |
+ void createZoneStrings(const UnicodeString *const * otherStrings); |
+ |
+ /** |
+ * Delete all the storage owned by this object. |
+ */ |
+ void dispose(void); |
+ |
+ /** |
+ * Copy all of the other's data to this. |
+ * @param other the object to be copied. |
+ */ |
+ void copyData(const DateFormatSymbols& other); |
+ |
+ |
+ /** |
+ * Returns a ZoneStringFormat, used only by SimpleDateFormat for now. |
+ */ |
+ const ZoneStringFormat* getZoneStringFormat(void) const; |
+ |
+ /** |
+ * Create a ZoneStringFormat by locale if not yet availble |
+ */ |
+ void initZoneStringFormat(void); |
+ |
+ /** |
+ * Create zone strings array by locale if not yet available |
+ */ |
+ void initZoneStringsArray(void); |
+ |
+ /** |
+ * Delete just the zone strings. |
+ */ |
+ void disposeZoneStrings(void); |
+}; |
+ |
+U_NAMESPACE_END |
+ |
+#endif /* #if !UCONFIG_NO_FORMATTING */ |
+ |
+#endif // _DTFMTSYM |
+//eof |
Property changes on: icu46/source/i18n/unicode/dtfmtsym.h |
___________________________________________________________________ |
Added: svn:eol-style |
+ LF |