| | 1 | /* |
| | 2 | ********************************************************************** |
| | 3 | * Copyright (c) 2004, International Business Machines |
| | 4 | * Corporation and others. All Rights Reserved. |
| | 5 | ********************************************************************** |
| | 6 | * Author: Alan Liu |
| | 7 | * Created: January 16 2004 |
| | 8 | * Since: ICU 2.8 |
| | 9 | ********************************************************************** |
| | 10 | */ |
| | 11 | #ifndef LOCBASED_H |
| | 12 | #define LOCBASED_H |
| | 13 | |
| | 14 | #include "unicode/locid.h" |
| | 15 | #include "unicode/uobject.h" |
| | 16 | |
| | 17 | /** |
| | 18 | * Macro to declare a locale LocaleBased wrapper object for the given |
| | 19 | * object, which must have two members named `validLocale' and |
| | 20 | * `actualLocale'. |
| | 21 | */ |
| | 22 | #define U_LOCALE_BASED(varname, objname) \ |
| | 23 | LocaleBased varname((objname).validLocale, (objname).actualLocale); |
| | 24 | |
| | 25 | U_NAMESPACE_BEGIN |
| | 26 | |
| | 27 | /** |
| | 28 | * A utility class that unifies the implementation of getLocale() by |
| | 29 | * various ICU services. This class is likely to be removed in the |
| | 30 | * ICU 3.0 time frame in favor of an integrated approach with the |
| | 31 | * services framework. |
| | 32 | * @since ICU 2.8 |
| | 33 | */ |
| | 34 | class U_COMMON_API LocaleBased : public UMemory { |
| | 35 | |
| | 36 | public: |
| | 37 | |
| | 38 | /** |
| | 39 | * Construct a LocaleBased wrapper around the two pointers. These |
| | 40 | * will be aliased for the lifetime of this object. |
| | 41 | */ |
| | 42 | inline LocaleBased(char* validAlias, char* actualAlias); |
| | 43 | |
| | 44 | /** |
| | 45 | * Construct a LocaleBased wrapper around the two const pointers. |
| | 46 | * These will be aliased for the lifetime of this object. |
| | 47 | */ |
| | 48 | inline LocaleBased(const char* validAlias, const char* actualAlias); |
| | 49 | |
| | 50 | /** |
| | 51 | * Return locale meta-data for the service object wrapped by this |
| | 52 | * object. Either the valid or the actual locale may be |
| | 53 | * retrieved. |
| | 54 | * @param type either ULOC_VALID_LOCALE or ULOC_ACTUAL_LOCALE |
| | 55 | * @param status input-output error code |
| | 56 | * @return the indicated locale |
| | 57 | */ |
| | 58 | Locale getLocale(ULocDataLocaleType type, UErrorCode& status) const; |
| | 59 | |
| | 60 | /** |
| | 61 | * Return the locale ID for the service object wrapped by this |
| | 62 | * object. Either the valid or the actual locale may be |
| | 63 | * retrieved. |
| | 64 | * @param type either ULOC_VALID_LOCALE or ULOC_ACTUAL_LOCALE |
| | 65 | * @param status input-output error code |
| | 66 | * @return the indicated locale ID |
| | 67 | */ |
| | 68 | const char* getLocaleID(ULocDataLocaleType type, UErrorCode& status) const; |
| | 69 | |
| | 70 | /** |
| | 71 | * Set the locale meta-data for the service object wrapped by this |
| | 72 | * object. If either parameter is zero, it is ignored. |
| | 73 | * @param valid the ID of the valid locale |
| | 74 | * @param actual the ID of the actual locale |
| | 75 | */ |
| | 76 | void setLocaleIDs(const char* valid, const char* actual); |
| | 77 | |
| | 78 | private: |
| | 79 | |
| | 80 | char* valid; |
| | 81 | |
| | 82 | char* actual; |
| | 83 | }; |
| | 84 | |
| | 85 | inline LocaleBased::LocaleBased(char* validAlias, char* actualAlias) : |
| | 86 | valid(validAlias), actual(actualAlias) { |
| | 87 | } |
| | 88 | |
| | 89 | inline LocaleBased::LocaleBased(const char* validAlias, |
| | 90 | const char* actualAlias) : |
| | 91 | // ugh: cast away const |
| | 92 | valid((char*)validAlias), actual((char*)actualAlias) { |
| | 93 | } |
| | 94 | |
| | 95 | U_NAMESPACE_END |
| | 96 | |
| | 97 | #endif |
projects / apple / icu.git / blame_incremental