ICU 77.1 77.1

locid.h
Go to the documentation of this file.
1 // © 2016 and later: Unicode, Inc. and others.
2 // License & terms of use: http://www.unicode.org/copyright.html
3 /*
4 ******************************************************************************
5 *
6 * Copyright (C) 1996-2015, International Business Machines
7 * Corporation and others. All Rights Reserved.
8 *
9 ******************************************************************************
10 *
11 * File locid.h
12 *
13 * Created by: Helena Shih
14 *
15 * Modification History:
16 *
17 * Date Name Description
18 * 02/11/97 aliu Changed gLocPath to fgLocPath and added methods to
19 * get and set it.
20 * 04/02/97 aliu Made operator!= inline; fixed return value of getName().
21 * 04/15/97 aliu Cleanup for AIX/Win32.
22 * 04/24/97 aliu Numerous changes per code review.
23 * 08/18/98 stephen Added tokenizeString(),changed getDisplayName()
24 * 09/08/98 stephen Moved definition of kEmptyString for Mac Port
25 * 11/09/99 weiv Added const char * getName() const;
26 * 04/12/00 srl removing unicodestring api's and cached hash code
27 * 08/10/01 grhoten Change the static Locales to accessor functions
28 ******************************************************************************
29 */
30
31 #ifndef LOCID_H
32 #define LOCID_H
33
34 #include "unicode/utypes.h"
35
36 #if U_SHOW_CPLUSPLUS_API
37
38 #include "unicode/bytestream.h"
39 #include "unicode/localpointer.h"
40 #include "unicode/strenum.h"
41 #include "unicode/stringpiece.h"
42 #include "unicode/uobject.h"
43 #include "unicode/putil.h"
44 #include "unicode/uloc.h"
45
51 U_NAMESPACE_BEGIN
52
53 // Forward Declarations
54 void U_CALLCONV locale_available_init();
56 class StringEnumeration;
57 class UnicodeString;
58
195 class U_COMMON_API Locale : public UObject {
196 public:
198 static const Locale& U_EXPORT2 getRoot();
200 static const Locale& U_EXPORT2 getEnglish();
202 static const Locale& U_EXPORT2 getFrench();
204 static const Locale& U_EXPORT2 getGerman();
206 static const Locale& U_EXPORT2 getItalian();
208 static const Locale& U_EXPORT2 getJapanese();
210 static const Locale& U_EXPORT2 getKorean();
212 static const Locale& U_EXPORT2 getChinese();
214 static const Locale& U_EXPORT2 getSimplifiedChinese();
216 static const Locale& U_EXPORT2 getTraditionalChinese();
217
219 static const Locale& U_EXPORT2 getFrance();
221 static const Locale& U_EXPORT2 getGermany();
223 static const Locale& U_EXPORT2 getItaly();
225 static const Locale& U_EXPORT2 getJapan();
227 static const Locale& U_EXPORT2 getKorea();
229 static const Locale& U_EXPORT2 getChina();
231 static const Locale& U_EXPORT2 getPRC();
233 static const Locale& U_EXPORT2 getTaiwan();
235 static const Locale& U_EXPORT2 getUK();
237 static const Locale& U_EXPORT2 getUS();
239 static const Locale& U_EXPORT2 getCanada();
241 static const Locale& U_EXPORT2 getCanadaFrench();
242
250 Locale();
251
276 Locale(const char* language,
277 const char* country = nullptr,
278 const char* variant = nullptr,
279 const char* keywordsAndValues = nullptr);
280
287 Locale(const Locale& other);
288
296 Locale(Locale&& other) noexcept;
297
302 virtual ~Locale() ;
303
311 Locale& operator=(const Locale& other);
312
322 Locale& operator=(Locale&& other) noexcept;
323
331 bool operator==(const Locale& other) const;
332
341 inline bool operator!=(const Locale& other) const;
342
354 Locale *clone() const;
355
356 #ifndef U_HIDE_SYSTEM_API
372 static const Locale& U_EXPORT2 getDefault();
373
386 static void U_EXPORT2 setDefault(const Locale& newLocale,
387 UErrorCode& success);
388 #endif /* U_HIDE_SYSTEM_API */
389
411 static Locale U_EXPORT2 forLanguageTag(StringPiece tag, UErrorCode& status);
412
426 void toLanguageTag(ByteSink& sink, UErrorCode& status) const;
427
438 template<typename StringClass>
439 inline StringClass toLanguageTag(UErrorCode& status) const;
440
450 static Locale U_EXPORT2 createFromName(const char *name);
451
452 #ifndef U_HIDE_INTERNAL_API
454 static Locale U_EXPORT2 createFromName(StringPiece name);
455 #endif /* U_HIDE_INTERNAL_API */
456
465 static Locale U_EXPORT2 createCanonical(const char* name);
466
472 inline const char * getLanguage( ) const;
473
481 inline const char * getScript( ) const;
482
488 inline const char * getCountry( ) const;
489
495 inline const char * getVariant( ) const;
496
505 inline const char * getName() const;
506
514 const char * getBaseName() const;
515
545 void addLikelySubtags(UErrorCode& status);
546
576 void minimizeSubtags(UErrorCode& status);
577
584 void canonicalize(UErrorCode& status);
585
595 StringEnumeration * createKeywords(UErrorCode &status) const;
596
606 StringEnumeration * createUnicodeKeywords(UErrorCode &status) const;
607
619 template<typename StringClass, typename OutputIterator>
620 inline void getKeywords(OutputIterator iterator, UErrorCode& status) const;
621
633 template<typename StringClass, typename OutputIterator>
634 inline void getUnicodeKeywords(OutputIterator iterator, UErrorCode& status) const;
635
652 int32_t getKeywordValue(const char* keywordName, char *buffer, int32_t bufferCapacity, UErrorCode &status) const;
653
667 void getKeywordValue(StringPiece keywordName, ByteSink& sink, UErrorCode& status) const;
668
682 template<typename StringClass>
683 inline StringClass getKeywordValue(StringPiece keywordName, UErrorCode& status) const;
684
698 void getUnicodeKeywordValue(StringPiece keywordName, ByteSink& sink, UErrorCode& status) const;
699
713 template<typename StringClass>
714 inline StringClass getUnicodeKeywordValue(StringPiece keywordName, UErrorCode& status) const;
715
735 void setKeywordValue(const char* keywordName, const char* keywordValue, UErrorCode &status) {
736 setKeywordValue(StringPiece{keywordName}, StringPiece{keywordValue}, status);
737 }
738
757 void setKeywordValue(StringPiece keywordName, StringPiece keywordValue, UErrorCode& status);
758
777 void setUnicodeKeywordValue(StringPiece keywordName, StringPiece keywordValue, UErrorCode& status);
778
785 const char * getISO3Language() const;
786
792 const char * getISO3Country() const;
793
801 uint32_t getLCID() const;
802
816 UBool isRightToLeft() const;
817
827 UnicodeString& getDisplayLanguage(UnicodeString& dispLang) const;
828
842 UnicodeString& getDisplayLanguage( const Locale& displayLocale,
843 UnicodeString& dispLang) const;
844
854 UnicodeString& getDisplayScript( UnicodeString& dispScript) const;
855
870 UnicodeString& getDisplayScript( const Locale& displayLocale,
871 UnicodeString& dispScript) const;
872
882 UnicodeString& getDisplayCountry( UnicodeString& dispCountry) const;
883
898 UnicodeString& getDisplayCountry( const Locale& displayLocale,
899 UnicodeString& dispCountry) const;
900
908 UnicodeString& getDisplayVariant( UnicodeString& dispVar) const;
909
918 UnicodeString& getDisplayVariant( const Locale& displayLocale,
919 UnicodeString& dispVar) const;
920
932 UnicodeString& getDisplayName( UnicodeString& name) const;
933
946 UnicodeString& getDisplayName( const Locale& displayLocale,
947 UnicodeString& name) const;
948
953 int32_t hashCode() const;
954
963 void setToBogus();
964
970 inline UBool isBogus() const;
971
980 static const Locale* U_EXPORT2 getAvailableLocales(int32_t& count);
981
990 static const char* const* U_EXPORT2 getISOCountries();
991
1003 static const char* const* U_EXPORT2 getISOLanguages();
1004
1010 static UClassID U_EXPORT2 getStaticClassID();
1011
1017 virtual UClassID getDynamicClassID() const override;
1018
1023 class U_COMMON_API Iterator /* not : public UObject because this is an interface/mixin class */ {
1024 public:
1026 virtual ~Iterator();
1027
1032 virtual UBool hasNext() const = 0;
1033
1038 virtual const Locale &next() = 0;
1039 };
1040
1045 template<typename Iter>
1046 class RangeIterator : public Iterator, public UMemory {
1047 public:
1057 RangeIterator(Iter begin, Iter end) : it_(begin), end_(end) {}
1058
1063 UBool hasNext() const override { return it_ != end_; }
1064
1069 const Locale &next() override { return *it_++; }
1070
1071 private:
1072 Iter it_;
1073 const Iter end_;
1074 };
1075
1081 template<typename Iter, typename Conv>
1082 class ConvertingIterator : public Iterator, public UMemory {
1083 public:
1094 ConvertingIterator(Iter begin, Iter end, Conv converter) :
1095 it_(begin), end_(end), converter_(converter) {}
1096
1101 UBool hasNext() const override { return it_ != end_; }
1102
1107 const Locale &next() override { return converter_(*it_++); }
1108
1109 private:
1110 Iter it_;
1111 const Iter end_;
1112 Conv converter_;
1113 };
1114
1115 protected: /* only protected for testing purposes. DO NOT USE. */
1116 #ifndef U_HIDE_INTERNAL_API
1121 void setFromPOSIXID(const char *posixID);
1130 void minimizeSubtags(bool favorScript, UErrorCode& status);
1131 #endif /* U_HIDE_INTERNAL_API */
1132
1133 private:
1141 Locale& init(const char* localeID, UBool canonicalize);
1143 Locale& init(StringPiece localeID, UBool canonicalize);
1144
1145 /*
1146 * Internal constructor to allow construction of a locale object with
1147 * NO side effects. (Default constructor tries to get
1148 * the default locale.)
1149 */
1150 enum ELocaleType {
1151 eBOGUS
1152 };
1153 Locale(ELocaleType);
1154
1158 static Locale* getLocaleCache();
1159
1160 char language[ULOC_LANG_CAPACITY];
1161 char script[ULOC_SCRIPT_CAPACITY];
1162 char country[ULOC_COUNTRY_CAPACITY];
1163 int32_t variantBegin;
1164 char* fullName;
1165 char fullNameBuffer[ULOC_FULLNAME_CAPACITY];
1166 // name without keywords
1167 char* baseName;
1168 void initBaseName(UErrorCode& status);
1169
1170 UBool fIsBogus;
1171
1172 static const Locale &getLocale(int locid);
1173
1178 friend Locale *locale_set_default_internal(const char *, UErrorCode& status);
1179
1183 friend void U_CALLCONV locale_available_init();
1184 };
1185
1186 inline bool
1187 Locale::operator!=(const Locale& other) const
1188 {
1189 return !operator==(other);
1190 }
1191
1192 template<typename StringClass> inline StringClass
1193 Locale::toLanguageTag(UErrorCode& status) const
1194 {
1195 if (U_FAILURE(status)) { return {}; }
1196 StringClass result;
1197 StringByteSink<StringClass> sink(&result);
1198 toLanguageTag(sink, status);
1199 return result;
1200 }
1201
1202 inline const char *
1203 Locale::getCountry() const
1204 {
1205 return country;
1206 }
1207
1208 inline const char *
1209 Locale::getLanguage() const
1210 {
1211 return language;
1212 }
1213
1214 inline const char *
1215 Locale::getScript() const
1216 {
1217 return script;
1218 }
1219
1220 inline const char *
1221 Locale::getVariant() const
1222 {
1223 return fIsBogus ? "" : &baseName[variantBegin];
1224 }
1225
1226 inline const char *
1227 Locale::getName() const
1228 {
1229 return fullName;
1230 }
1231
1232 template<typename StringClass, typename OutputIterator> inline void
1233 Locale::getKeywords(OutputIterator iterator, UErrorCode& status) const
1234 {
1235 if (U_FAILURE(status)) { return; }
1236 LocalPointer<StringEnumeration> keys(createKeywords(status));
1237 if (U_FAILURE(status) || keys.isNull()) {
1238 return;
1239 }
1240 for (;;) {
1241 int32_t resultLength;
1242 const char* buffer = keys->next(&resultLength, status);
1243 if (U_FAILURE(status) || buffer == nullptr) {
1244 return;
1245 }
1246 *iterator++ = StringClass(buffer, resultLength);
1247 }
1248 }
1249
1250 template<typename StringClass, typename OutputIterator> inline void
1251 Locale::getUnicodeKeywords(OutputIterator iterator, UErrorCode& status) const
1252 {
1253 if (U_FAILURE(status)) { return; }
1254 LocalPointer<StringEnumeration> keys(createUnicodeKeywords(status));
1255 if (U_FAILURE(status) || keys.isNull()) {
1256 return;
1257 }
1258 for (;;) {
1259 int32_t resultLength;
1260 const char* buffer = keys->next(&resultLength, status);
1261 if (U_FAILURE(status) || buffer == nullptr) {
1262 return;
1263 }
1264 *iterator++ = StringClass(buffer, resultLength);
1265 }
1266 }
1267
1268 template<typename StringClass> inline StringClass
1269 Locale::getKeywordValue(StringPiece keywordName, UErrorCode& status) const
1270 {
1271 if (U_FAILURE(status)) { return {}; }
1272 StringClass result;
1273 StringByteSink<StringClass> sink(&result);
1274 getKeywordValue(keywordName, sink, status);
1275 return result;
1276 }
1277
1278 template<typename StringClass> inline StringClass
1279 Locale::getUnicodeKeywordValue(StringPiece keywordName, UErrorCode& status) const
1280 {
1281 if (U_FAILURE(status)) { return {}; }
1282 StringClass result;
1283 StringByteSink<StringClass> sink(&result);
1284 getUnicodeKeywordValue(keywordName, sink, status);
1285 return result;
1286 }
1287
1288 inline UBool
1289 Locale::isBogus() const {
1290 return fIsBogus;
1291 }
1292
1293 U_NAMESPACE_END
1294
1295 #endif /* U_SHOW_CPLUSPLUS_API */
1296
1297 #endif
bytestream.h
C++ API: Interface for writing bytes, and implementation classes.
icu::ByteSink
A ByteSink can be filled with bytes.
Definition: bytestream.h:53
icu::LocalPointerBase::isNull
UBool isNull() const
nullptr check.
Definition: localpointer.h:94
icu::LocalPointer
"Smart pointer" class, deletes objects via the standard C++ delete operator.
Definition: localpointer.h:191
icu::Locale::ConvertingIterator
A generic Locale iterator implementation over Locale input iterators.
Definition: locid.h:1082
icu::Locale::ConvertingIterator::hasNext
UBool hasNext() const override
Definition: locid.h:1101
icu::Locale::ConvertingIterator::ConvertingIterator
ConvertingIterator(Iter begin, Iter end, Conv converter)
Constructs an iterator from a begin/end range.
Definition: locid.h:1094
icu::Locale::ConvertingIterator::next
const Locale & next() override
Definition: locid.h:1107
icu::Locale::Iterator
A Locale iterator interface similar to a Java Iterator<Locale>.
Definition: locid.h:1023
icu::Locale::Iterator::hasNext
virtual UBool hasNext() const =0
icu::Locale::Iterator::~Iterator
virtual ~Iterator()
icu::Locale::Iterator::next
virtual const Locale & next()=0
icu::Locale::RangeIterator
A generic Locale iterator implementation over Locale input iterators.
Definition: locid.h:1046
icu::Locale::RangeIterator::RangeIterator
RangeIterator(Iter begin, Iter end)
Constructs an iterator from a begin/end range.
Definition: locid.h:1057
icu::Locale::RangeIterator::hasNext
UBool hasNext() const override
Definition: locid.h:1063
icu::Locale::RangeIterator::next
const Locale & next() override
Definition: locid.h:1069
icu::Locale
A Locale object represents a specific geographical, political, or cultural region.
Definition: locid.h:195
icu::Locale::getGerman
static const Locale & getGerman()
Useful constant for this language.
icu::Locale::minimizeSubtags
void minimizeSubtags(UErrorCode &status)
Minimize the subtags for this Locale, per the algorithm described in the following CLDR technical rep...
icu::Locale::getAvailableLocales
static const Locale * getAvailableLocales(int32_t &count)
Returns a list of all installed locales.
icu::Locale::minimizeSubtags
void minimizeSubtags(bool favorScript, UErrorCode &status)
Minimize the subtags for this Locale, per the algorithm described.
icu::Locale::getISOCountries
static const char *const * getISOCountries()
Gets a list of all available 2-letter country codes defined in ISO 3166.
icu::Locale::createFromName
static Locale createFromName(const char *name)
Creates a locale which has had minimal canonicalization as per uloc_getName().
icu::Locale::getChina
static const Locale & getChina()
Useful constant for this country/region.
icu::Locale::locale_available_init
friend void locale_available_init()
icu::Locale::locale_set_default_internal
friend Locale * locale_set_default_internal(const char *, UErrorCode &status)
A friend to allow the default locale to be set by either the C or C++ API.
icu::Locale::createCanonical
static Locale createCanonical(const char *name)
Creates a locale from the given string after canonicalizing the string according to CLDR by calling u...
icu::Locale::getDisplayCountry
UnicodeString & getDisplayCountry(const Locale &displayLocale, UnicodeString &dispCountry) const
Fills in "dispCountry" with the name of this locale's country in a format suitable for user display i...
icu::Locale::getStaticClassID
static UClassID getStaticClassID()
ICU "poor man's RTTI", returns a UClassID for this class.
icu::Locale::Locale
Locale()
Construct a default locale object, a Locale for the default locale ID.
icu::Locale::clone
Locale * clone() const
Clone this object.
icu::Locale::setKeywordValue
void setKeywordValue(const char *keywordName, const char *keywordValue, UErrorCode &status)
Sets or removes the value for a keyword.
Definition: locid.h:735
icu::Locale::getDisplayCountry
UnicodeString & getDisplayCountry(UnicodeString &dispCountry) const
Fills in "dispCountry" with the name of this locale's country in a format suitable for user display i...
icu::Locale::getFrench
static const Locale & getFrench()
Useful constant for this language.
icu::Locale::operator=
Locale & operator=(Locale &&other) noexcept
Move assignment operator; might leave source in bogus state.
icu::Locale::getDisplayLanguage
UnicodeString & getDisplayLanguage(const Locale &displayLocale, UnicodeString &dispLang) const
Fills in "dispLang" with the name of this locale's language in a format suitable for user display in ...
icu::Locale::Locale
Locale(const char *language, const char *country=nullptr, const char *variant=nullptr, const char *keywordsAndValues=nullptr)
Construct a locale from language, country, variant.
icu::Locale::getChinese
static const Locale & getChinese()
Useful constant for this language.
icu::Locale::getISOLanguages
static const char *const * getISOLanguages()
Returns a list of all unique language codes defined in ISO 639.
icu::Locale::getItalian
static const Locale & getItalian()
Useful constant for this language.
icu::Locale::getISO3Country
const char * getISO3Country() const
Fills in "name" with the locale's three-letter ISO-3166 country code.
icu::Locale::getUS
static const Locale & getUS()
Useful constant for this country/region.
icu::Locale::getPRC
static const Locale & getPRC()
Useful constant for this country/region.
icu::Locale::getDisplayName
UnicodeString & getDisplayName(UnicodeString &name) const
Fills in "name" with the name of this locale in a format suitable for user display in the default loc...
icu::Locale::~Locale
virtual ~Locale()
Destructor.
icu::Locale::getKeywordValue
int32_t getKeywordValue(const char *keywordName, char *buffer, int32_t bufferCapacity, UErrorCode &status) const
Gets the value for a keyword.
icu::Locale::setDefault
static void setDefault(const Locale &newLocale, UErrorCode &success)
Sets the default.
icu::Locale::getTraditionalChinese
static const Locale & getTraditionalChinese()
Useful constant for this language.
icu::Locale::getEnglish
static const Locale & getEnglish()
Useful constant for this language.
icu::Locale::createFromName
static Locale createFromName(StringPiece name)
icu::Locale::operator==
bool operator==(const Locale &other) const
Checks if two locale keys are the same.
icu::Locale::createKeywords
StringEnumeration * createKeywords(UErrorCode &status) const
Gets the list of keywords for the specified locale.
icu::Locale::getCanadaFrench
static const Locale & getCanadaFrench()
Useful constant for this country/region.
icu::Locale::getItaly
static const Locale & getItaly()
Useful constant for this country/region.
icu::Locale::getRoot
static const Locale & getRoot()
Useful constant for the Root locale.
icu::Locale::getKorea
static const Locale & getKorea()
Useful constant for this country/region.
icu::Locale::getDisplayLanguage
UnicodeString & getDisplayLanguage(UnicodeString &dispLang) const
Fills in "dispLang" with the name of this locale's language in a format suitable for user display in ...
icu::Locale::setKeywordValue
void setKeywordValue(StringPiece keywordName, StringPiece keywordValue, UErrorCode &status)
Sets or removes the value for a keyword.
icu::Locale::setUnicodeKeywordValue
void setUnicodeKeywordValue(StringPiece keywordName, StringPiece keywordValue, UErrorCode &status)
Sets or removes the Unicode value for a Unicode keyword.
icu::Locale::createUnicodeKeywords
StringEnumeration * createUnicodeKeywords(UErrorCode &status) const
Gets the list of Unicode keywords for the specified locale.
icu::Locale::toLanguageTag
void toLanguageTag(ByteSink &sink, UErrorCode &status) const
Returns a well-formed language tag for this Locale.
icu::Locale::getBaseName
const char * getBaseName() const
Returns the programmatic name of the entire locale as getName() would return, but without keywords.
icu::Locale::getDisplayName
UnicodeString & getDisplayName(const Locale &displayLocale, UnicodeString &name) const
Fills in "name" with the name of this locale in a format suitable for user display in the locale spec...
icu::Locale::setToBogus
void setToBogus()
Sets the locale to bogus A bogus locale represents a non-existing locale associated with services tha...
icu::Locale::addLikelySubtags
void addLikelySubtags(UErrorCode &status)
Add the likely subtags for this Locale, per the algorithm described in the following CLDR technical r...
icu::Locale::operator=
Locale & operator=(const Locale &other)
Replaces the entire contents of *this with the specified value.
icu::Locale::getJapanese
static const Locale & getJapanese()
Useful constant for this language.
icu::Locale::getUK
static const Locale & getUK()
Useful constant for this country/region.
icu::Locale::canonicalize
void canonicalize(UErrorCode &status)
Canonicalize the locale ID of this object according to CLDR.
icu::Locale::getKorean
static const Locale & getKorean()
Useful constant for this language.
icu::Locale::getJapan
static const Locale & getJapan()
Useful constant for this country/region.
icu::Locale::hashCode
int32_t hashCode() const
Generates a hash code for the locale.
icu::Locale::getLCID
uint32_t getLCID() const
Returns the Windows LCID value corresponding to this locale.
icu::Locale::Locale
Locale(const Locale &other)
Initializes a Locale object from another Locale object.
icu::Locale::getGermany
static const Locale & getGermany()
Useful constant for this country/region.
icu::Locale::getDisplayVariant
UnicodeString & getDisplayVariant(UnicodeString &dispVar) const
Fills in "dispVar" with the name of this locale's variant code in a format suitable for user display ...
icu::Locale::getISO3Language
const char * getISO3Language() const
returns the locale's three-letter language code, as specified in ISO draft standard ISO-639-2.
icu::Locale::getUnicodeKeywordValue
void getUnicodeKeywordValue(StringPiece keywordName, ByteSink &sink, UErrorCode &status) const
Gets the Unicode value for a Unicode keyword.
icu::Locale::getDisplayScript
UnicodeString & getDisplayScript(const Locale &displayLocale, UnicodeString &dispScript) const
Fills in "dispScript" with the name of this locale's country in a format suitable for user display in...
icu::Locale::getDisplayScript
UnicodeString & getDisplayScript(UnicodeString &dispScript) const
Fills in "dispScript" with the name of this locale's script in a format suitable for user display in ...
icu::Locale::getSimplifiedChinese
static const Locale & getSimplifiedChinese()
Useful constant for this language.
icu::Locale::getCanada
static const Locale & getCanada()
Useful constant for this country/region.
icu::Locale::isRightToLeft
UBool isRightToLeft() const
Returns whether this locale's script is written right-to-left.
icu::Locale::setFromPOSIXID
void setFromPOSIXID(const char *posixID)
Set this from a single POSIX style locale string.
icu::Locale::getDefault
static const Locale & getDefault()
Common methods of getting the current default Locale.
icu::Locale::getKeywordValue
void getKeywordValue(StringPiece keywordName, ByteSink &sink, UErrorCode &status) const
Gets the value for a keyword.
icu::Locale::getDisplayVariant
UnicodeString & getDisplayVariant(const Locale &displayLocale, UnicodeString &dispVar) const
Fills in "dispVar" with the name of this locale's variant code in a format suitable for user display ...
icu::Locale::getFrance
static const Locale & getFrance()
Useful constant for this country/region.
icu::Locale::getDynamicClassID
virtual UClassID getDynamicClassID() const override
ICU "poor man's RTTI", returns a UClassID for the actual class.
icu::Locale::getTaiwan
static const Locale & getTaiwan()
Useful constant for this country/region.
icu::Locale::forLanguageTag
static Locale forLanguageTag(StringPiece tag, UErrorCode &status)
Returns a Locale for the specified BCP47 language tag string.
icu::Locale::Locale
Locale(Locale &&other) noexcept
Move constructor; might leave source in bogus state.
icu::StringByteSink
Implementation of ByteSink that writes to a "string".
Definition: bytestream.h:267
icu::StringEnumeration
Base class for 'pure' C++ implementations of uenum api.
Definition: strenum.h:61
icu::StringPiece
A string-like object that points to a sized piece of memory.
Definition: stringpiece.h:61
icu::UMemory
UMemory is the common ICU base class.
Definition: uobject.h:115
icu::UObject
UObject is the common ICU "boilerplate" class.
Definition: uobject.h:223
icu::UnicodeString
UnicodeString is a string class that stores Unicode characters directly and provides similar function...
Definition: unistr.h:296
localpointer.h
C++ API: "Smart pointers" for use with and in ICU4C C++ code.
icu::operator==
U_EXPORT UBool operator==(const StringPiece &x, const StringPiece &y)
Global operator == for StringPiece.
icu::locale_available_init
void locale_available_init()
icu::operator!=
bool operator!=(const StringPiece &x, const StringPiece &y)
Global operator != for StringPiece.
Definition: stringpiece.h:346
U_CALLCONV
#define U_CALLCONV
Similar to U_CDECL_BEGIN/U_CDECL_END, this qualifier is necessary in callback function typedefs to ma...
Definition: platform.h:846
putil.h
C API: Platform Utilities.
strenum.h
C++ API: String Enumeration.
stringpiece.h
C++ API: StringPiece: Read-only byte string wrapper class.
uloc.h
C API: Locale ID functionality similar to C++ class Locale.
ULOC_SCRIPT_CAPACITY
#define ULOC_SCRIPT_CAPACITY
Useful constant for the maximum size of the script part of a locale ID (including the terminating NUL...
Definition: uloc.h:271
ULOC_COUNTRY_CAPACITY
#define ULOC_COUNTRY_CAPACITY
Useful constant for the maximum size of the country part of a locale ID (including the terminating NU...
Definition: uloc.h:258
ULOC_LANG_CAPACITY
#define ULOC_LANG_CAPACITY
Useful constant for the maximum size of the language part of a locale ID.
Definition: uloc.h:251
ULOC_FULLNAME_CAPACITY
#define ULOC_FULLNAME_CAPACITY
Useful constant for the maximum size of the whole locale ID (including the terminating NULL and all k...
Definition: uloc.h:264
UBool
int8_t UBool
The ICU boolean type, a signed-byte integer.
Definition: umachine.h:247
uobject.h
C++ API: Common ICU base class UObject.
UClassID
void * UClassID
UClassID is used to identify classes without using the compiler's RTTI.
Definition: uobject.h:96
utypes.h
Basic definitions for ICU, for both C and C++ APIs.
UErrorCode
UErrorCode
Standard ICU4C error code type, a substitute for exceptions.
Definition: utypes.h:430
U_FAILURE
#define U_FAILURE(x)
Does the error code indicate a failure?
Definition: utypes.h:748
U_COMMON_API
#define U_COMMON_API
Set to export library symbols from inside the common library, and to import them from outside.
Definition: utypes.h:315