Language
code,
Language_Country
code, or Language_Country_Variant
code, e.g., "en_US". The two-letter Language
code uses the ISO-639-1 standard,
e.g., "en" stands for English, "pl" -- Polish, "fr" -- French,
and "de" for German. Country
is a two-letter code following the ISO-3166 standard.
This is to reflect different language conventions within the same language,
for example in US-English ("en_US") and Australian-English ("en_AU"). Differences may also appear in language conventions used within
the same country. For example, the Euro currency may be used in several European
countries while the individual country's currency is still in circulation.
In such case, ICU Variant
"_EURO" could be used for selecting
locales that support the Euro currency. The final (optional) element of a locale is an optional list of
keywords together with their values. Keywords must be unique.
Their order is not significant. Unknown keywords are ignored.
The handling of keywords depends on the specific services that
utilize them. Currently, the following keywords are recognized:
calendar
, colation
, currency
, and numbers
,
e.g., fr@collation=phonebook;
calendar=islamic-civil
is a valid
French locale specifier together with keyword arguments. For
more information, refer to the ICU user guide. For a list of locales that are recognized by ICU,
call stri_locale_list
.NULL
is provided
as its locale
argument. Default locales are available to all the functions:
they are initially set to be the system locale on that platform,
and may be changed with stri_locale_set
,
for example, if automatic detection fails to recognize
your locale properly. Sometimes it is suggested that your program should avoid changing the default locale:
it is not a good way to request an international object, especially
only for a single function call.
All locale-sensitive functions may request
any desired locale per-call (by specifying the locale
argument),
i.e., without referencing to the default locale.
During many tests, however, we did not observe any improper
behavior of stringi while using a modified default locale.stri_opts_collator
for the description on how to tune its settings, and its locale
argument in particular. Other locale-sensitive functions include, e.g.,
stri_trans_tolower
(that does character case mapping).ISO 639: Language Codes, http://www.iso.org/iso/home/standards/language_codes.htm
ISO 3166: Country Codes, http://www.iso.org/iso/country_codes
stri_locale_info
,
stri_locale_list
,
stri_locale_set
Other locale_sensitive: %s<%< a="">%<>
,
stri_compare
,
stri_count_boundaries
,
stri_duplicated
,
stri_enc_detect2
,
stri_extract_all_boundaries
,
stri_locate_all_boundaries
,
stri_opts_collator
,
stri_order
,
stri_split_boundaries
,
stri_trans_tolower
,
stri_unique
, stri_wrap
,
stringi-search-boundaries
,
stringi-search-coll
Other stringi_general_topics: stringi-arguments
,
stringi-encoding
,
stringi-package
,
stringi-search-boundaries
,
stringi-search-charclass
,
stringi-search-coll
,
stringi-search-fixed
,
stringi-search-regex
,
stringi-search