36#if U_SHOW_CPLUSPLUS_API
277 const char* country =
nullptr,
278 const char* variant =
nullptr,
279 const char* keywordsAndValues =
nullptr);
356#ifndef U_HIDE_SYSTEM_API
438 template<
typename StringClass>
500 inline const char *
getName()
const;
614 template<
typename StringClass,
typename OutputIterator>
628 template<
typename StringClass,
typename OutputIterator>
677 template<
typename StringClass>
708 template<
typename StringClass>
1040 template<
typename Iter>
1076 template<
typename Iter,
typename Conv>
1090 it_(begin), end_(end), converter_(converter) {}
1111#ifndef U_HIDE_INTERNAL_API
1151 static Locale* getLocaleCache();
1156 int32_t variantBegin;
1165 static const Locale &getLocale(
int locid);
1185template<
typename StringClass>
inline StringClass
1216 return fIsBogus ?
"" : &baseName[variantBegin];
1225template<
typename StringClass,
typename OutputIterator>
inline void
1234 int32_t resultLength;
1235 const char* buffer = keys->next(&resultLength, status);
1236 if (
U_FAILURE(status) || buffer ==
nullptr) {
1239 *iterator++ = StringClass(buffer, resultLength);
1243template<
typename StringClass,
typename OutputIterator>
inline void
1252 int32_t resultLength;
1253 const char* buffer = keys->next(&resultLength, status);
1254 if (
U_FAILURE(status) || buffer ==
nullptr) {
1257 *iterator++ = StringClass(buffer, resultLength);
1261template<
typename StringClass>
inline StringClass
1271template<
typename StringClass>
inline StringClass
C++ API: Interface for writing bytes, and implementation classes.
A ByteSink can be filled with bytes.
UBool isNull() const
nullptr check.
"Smart pointer" class, deletes objects via the standard C++ delete operator.
const Locale & next() override
UBool hasNext() const override
ConvertingIterator(Iter begin, Iter end, Conv converter)
Constructs an iterator from a begin/end range.
A Locale iterator interface similar to a Java Iterator<Locale>.
virtual UBool hasNext() const =0
virtual const Locale & next()=0
RangeIterator(Iter begin, Iter end)
Constructs an iterator from a begin/end range.
UBool hasNext() const override
const Locale & next() override
A Locale object represents a specific geographical, political, or cultural region.
void minimizeSubtags(UErrorCode &status)
Minimize the subtags for this Locale, per the algorithm described in the following CLDR technical rep...
void minimizeSubtags(bool favorScript, UErrorCode &status)
Minimize the subtags for this Locale, per the algorithm described.
static const char *const * getISOLanguages()
Returns a list of all unique language codes defined in ISO 639.
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.
static Locale createFromName(const char *name)
Creates a locale which has had minimal canonicalization as per uloc_getName().
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 ...
static const Locale & getPRC()
Useful constant for this country/region.
static const Locale & getGermany()
Useful constant for this country/region.
friend void locale_available_init()
static Locale createCanonical(const char *name)
Creates a locale from the given string after canonicalizing the string according to CLDR by calling u...
static const Locale & getDefault()
Common methods of getting the current default Locale.
static UClassID getStaticClassID()
ICU "poor man's RTTI", returns a UClassID for this class.
Locale()
Construct a default locale object, a Locale for the default locale ID.
void setKeywordValue(const char *keywordName, const char *keywordValue, UErrorCode &status)
Sets or removes the value for a keyword.
const char * getBaseName() const
Returns the programmatic name of the entire locale as getName() would return, but without keywords.
Locale & operator=(const Locale &other)
Replaces the entire contents of *this with the specified value.
static const Locale & getCanadaFrench()
Useful constant for this country/region.
Locale(const char *language, const char *country=nullptr, const char *variant=nullptr, const char *keywordsAndValues=nullptr)
Construct a locale from language, country, variant.
static const Locale & getEnglish()
Useful constant for this language.
static const Locale & getJapan()
Useful constant for this country/region.
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...
const char * getScript() const
Returns the locale's ISO-15924 abbreviation script code.
static const Locale & getChinese()
Useful constant for this language.
static const Locale & getUS()
Useful constant for this country/region.
virtual ~Locale()
Destructor.
const char * getISO3Language() const
returns the locale's three-letter language code, as specified in ISO draft standard ISO-639-2.
int32_t getKeywordValue(const char *keywordName, char *buffer, int32_t bufferCapacity, UErrorCode &status) const
Gets the value for a keyword.
static void setDefault(const Locale &newLocale, UErrorCode &success)
Sets the default.
static const Locale & getTraditionalChinese()
Useful constant for this language.
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 ...
Locale & operator=(Locale &&other) noexcept
Move assignment operator; might leave source in bogus state.
void getUnicodeKeywords(OutputIterator iterator, UErrorCode &status) const
Gets the set of Unicode keywords for this Locale.
StringEnumeration * createKeywords(UErrorCode &status) const
Gets the list of keywords for the specified locale.
const char * getVariant() const
Returns the locale's variant code.
bool operator==(const Locale &other) const
Checks if two locale keys are the same.
static const Locale & getSimplifiedChinese()
Useful constant for this language.
static const Locale * getAvailableLocales(int32_t &count)
Returns a list of all installed locales.
void setKeywordValue(StringPiece keywordName, StringPiece keywordValue, UErrorCode &status)
Sets or removes the value for a keyword.
void setUnicodeKeywordValue(StringPiece keywordName, StringPiece keywordValue, UErrorCode &status)
Sets or removes the Unicode value for a Unicode keyword.
void toLanguageTag(ByteSink &sink, UErrorCode &status) const
Returns a well-formed language tag for this Locale.
const char * getName() const
Returns the programmatic name of the entire locale, with the language, country and variant separated ...
bool operator!=(const Locale &other) const
Checks if two locale keys are not the same.
void setToBogus()
Sets the locale to bogus A bogus locale represents a non-existing locale associated with services tha...
UnicodeString & getDisplayVariant(UnicodeString &dispVar) const
Fills in "dispVar" with the name of this locale's variant code in a format suitable for user display ...
static const Locale & getKorea()
Useful constant for this country/region.
void addLikelySubtags(UErrorCode &status)
Add the likely subtags for this Locale, per the algorithm described in the following CLDR technical r...
static const Locale & getCanada()
Useful constant for this country/region.
void canonicalize(UErrorCode &status)
Canonicalize the locale ID of this object according to CLDR.
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...
const char * getISO3Country() const
Fills in "name" with the locale's three-letter ISO-3166 country code.
int32_t hashCode() const
Generates a hash code for the locale.
uint32_t getLCID() const
Returns the Windows LCID value corresponding to this locale.
void getKeywords(OutputIterator iterator, UErrorCode &status) const
Gets the set of keywords for this Locale.
UnicodeString & getDisplayCountry(UnicodeString &dispCountry) const
Fills in "dispCountry" with the name of this locale's country in a format suitable for user display i...
static const Locale & getGerman()
Useful constant for this language.
Locale(const Locale &other)
Initializes a Locale object from another Locale object.
static const Locale & getChina()
Useful constant for this country/region.
void getUnicodeKeywordValue(StringPiece keywordName, ByteSink &sink, UErrorCode &status) const
Gets the Unicode value for a Unicode keyword.
StringEnumeration * createUnicodeKeywords(UErrorCode &status) const
Gets the list of Unicode keywords for the specified locale.
static const char *const * getISOCountries()
Gets a list of all available 2-letter country codes defined in ISO 3166.
UnicodeString & getDisplayScript(UnicodeString &dispScript) const
Fills in "dispScript" with the name of this locale's script in a format suitable for user display in ...
static const Locale & getItalian()
Useful constant for this language.
static const Locale & getTaiwan()
Useful constant for this country/region.
UBool isRightToLeft() const
Returns whether this locale's script is written right-to-left.
static const Locale & getKorean()
Useful constant for this language.
static const Locale & getJapanese()
Useful constant for this language.
static const Locale & getRoot()
Useful constant for the Root locale.
static const Locale & getFrance()
Useful constant for this country/region.
const char * getCountry() const
Returns the locale's ISO-3166 country code.
static const Locale & getUK()
Useful constant for this country/region.
UnicodeString & getDisplayLanguage(UnicodeString &dispLang) const
Fills in "dispLang" with the name of this locale's language in a format suitable for user display in ...
void setFromPOSIXID(const char *posixID)
Set this from a single POSIX style locale string.
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...
void getKeywordValue(StringPiece keywordName, ByteSink &sink, UErrorCode &status) const
Gets the value for a keyword.
const char * getLanguage() const
Returns the locale's ISO-639 language code.
virtual UClassID getDynamicClassID() const override
ICU "poor man's RTTI", returns a UClassID for the actual class.
Locale * clone() const
Clone this object.
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...
static const Locale & getFrench()
Useful constant for this language.
static Locale forLanguageTag(StringPiece tag, UErrorCode &status)
Returns a Locale for the specified BCP47 language tag string.
Locale(Locale &&other) noexcept
Move constructor; might leave source in bogus state.
UBool isBogus() const
Gets the bogus state.
static const Locale & getItaly()
Useful constant for this country/region.
Implementation of ByteSink that writes to a "string".
Base class for 'pure' C++ implementations of uenum api.
A string-like object that points to a sized piece of memory.
UMemory is the common ICU base class.
UObject is the common ICU "boilerplate" class.
UnicodeString is a string class that stores Unicode characters directly and provides similar function...
C++ API: "Smart pointers" for use with and in ICU4C C++ code.
void locale_available_init()
bool operator!=(const StringPiece &x, const StringPiece &y)
Global operator != for StringPiece.
C API: Platform Utilities.
C++ API: String Enumeration.
C++ API: StringPiece: Read-only byte string wrapper class.
C API: Locale ID functionality similar to C++ class Locale.
#define ULOC_SCRIPT_CAPACITY
Useful constant for the maximum size of the script part of a locale ID (including the terminating NUL...
#define ULOC_COUNTRY_CAPACITY
Useful constant for the maximum size of the country part of a locale ID (including the terminating NU...
#define ULOC_LANG_CAPACITY
Useful constant for the maximum size of the language part of a locale ID.
#define ULOC_FULLNAME_CAPACITY
Useful constant for the maximum size of the whole locale ID (including the terminating NULL and all k...
int8_t UBool
The ICU boolean type, a signed-byte integer.
C++ API: Common ICU base class UObject.
void * UClassID
UClassID is used to identify classes without using the compiler's RTTI.
Basic definitions for ICU, for both C and C++ APIs.
UErrorCode
Standard ICU4C error code type, a substitute for exceptions.
#define U_FAILURE(x)
Does the error code indicate a failure?
#define U_COMMON_API
Set to export library symbols from inside the common library, and to import them from outside.