OXIESEC PANEL
- Current Dir:
/
/
opt
/
alt
/
alt-nodejs22
/
root
/
usr
/
include
/
unicode
Server IP: 2a02:4780:11:1594:0:ef5:22d7:a
Upload:
Create Dir:
Name
Size
Modified
Perms
π
..
-
10/21/2025 06:56:31 AM
rwxr-xr-x
π
alphaindex.h
26.54 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
appendable.h
8.54 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
basictz.h
9.99 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
brkiter.h
27.84 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
bytestream.h
10.77 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
bytestrie.h
20.83 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
bytestriebuilder.h
7.48 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
calendar.h
107.54 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
caniter.h
7.53 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
casemap.h
25.42 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
char16ptr.h
10.79 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
chariter.h
23.79 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
choicfmt.h
23.99 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
coleitr.h
13.78 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
coll.h
59.6 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
compactdecimalformat.h
6.88 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
curramt.h
3.67 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
currpinf.h
7.3 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
currunit.h
4.02 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
datefmt.h
40.7 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
dbbi.h
1.19 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
dcfmtsym.h
20.96 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
decimfmt.h
87.46 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
displayoptions.h
7.08 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
docmain.h
7.6 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
dtfmtsym.h
38.22 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
dtintrv.h
3.84 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
dtitvfmt.h
48.87 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
dtitvinf.h
18.63 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
dtptngen.h
28.05 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
dtrule.h
8.66 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
edits.h
20.74 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
enumset.h
2.08 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
errorcode.h
4.84 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
fieldpos.h
8.69 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
filteredbrk.h
5.37 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
fmtable.h
24.37 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
format.h
12.51 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
formattednumber.h
6.28 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
formattedvalue.h
9.75 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
fpositer.h
3.03 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
gender.h
3.35 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
gregocal.h
30.32 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
icudataver.h
1.02 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
icuplug.h
12.1 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
idna.h
12.93 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
listformatter.h
8.59 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
localebuilder.h
11.08 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
localematcher.h
26.86 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
localpointer.h
19.55 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
locdspnm.h
7.12 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
locid.h
48.62 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
measfmt.h
11.41 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
measunit.h
111.44 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
measure.h
4.63 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
messageformat2.h
21.05 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
messageformat2_arguments.h
4.49 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
messageformat2_data_model.h
101.89 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
messageformat2_data_model_names.h
784 bytes
06/06/2025 11:36:00 AM
rw-r--r--
π
messageformat2_formattable.h
38.36 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
messageformat2_function_registry.h
18.07 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
messagepattern.h
33.79 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
msgfmt.h
44.2 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
normalizer2.h
34.68 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
normlzr.h
30.79 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
nounit.h
2.24 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
numberformatter.h
90.69 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
numberrangeformatter.h
26 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
numfmt.h
50.16 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
numsys.h
7.22 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
parseerr.h
3.08 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
parsepos.h
5.56 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
platform.h
27.18 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
plurfmt.h
25.07 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
plurrule.h
20.63 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ptypes.h
2.16 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
putil.h
6.32 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
rbbi.h
32.04 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
rbnf.h
56.16 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
rbtz.h
15.75 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
regex.h
84.45 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
region.h
9.2 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
reldatefmt.h
22.48 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
rep.h
9.38 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
resbund.h
18.02 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
schriter.h
6.09 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
scientificnumberformatter.h
6.44 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
search.h
22.21 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
selfmt.h
14.35 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
simpleformatter.h
12.6 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
simplenumberformatter.h
8.87 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
simpletz.h
45.62 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
smpdtfmt.h
57.06 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
sortkey.h
11.13 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
std_string.h
1.05 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
strenum.h
9.96 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
stringoptions.h
5.79 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
stringpiece.h
10.28 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
stringtriebuilder.h
15.53 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
stsearch.h
21.43 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
symtable.h
4.28 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
tblcoll.h
36.96 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
timezone.h
45.59 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
tmunit.h
3.4 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
tmutamt.h
4.9 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
tmutfmt.h
7.42 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
translit.h
65.81 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
tzfmt.h
42.95 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
tznames.h
16.85 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
tzrule.h
34.81 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
tztrans.h
6.11 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ubidi.h
89.61 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ubiditransform.h
12.71 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ubrk.h
24.43 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ucal.h
63.96 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ucasemap.h
15.27 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ucat.h
5.35 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uchar.h
151.74 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ucharstrie.h
22.59 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ucharstriebuilder.h
7.48 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uchriter.h
13.24 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uclean.h
11.21 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ucnv.h
83.34 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ucnv_cb.h
6.58 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ucnv_err.h
20.98 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ucnvsel.h
6.24 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ucol.h
67.28 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ucoleitr.h
9.82 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uconfig.h
12.56 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ucpmap.h
5.54 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ucptrie.h
22.51 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ucsdet.h
14.69 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ucurr.h
16.72 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
udat.h
62.36 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
udata.h
15.63 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
udateintervalformat.h
11.93 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
udatpg.h
30.13 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
udisplaycontext.h
5.94 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
udisplayoptions.h
8.86 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uenum.h
7.79 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ufieldpositer.h
4.41 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uformattable.h
10.97 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uformattednumber.h
8.09 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uformattedvalue.h
12.25 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ugender.h
2.06 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uidna.h
34.12 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uiter.h
22.75 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uldnames.h
10.48 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ulistformatter.h
10.78 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uloc.h
55.38 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ulocale.h
6.31 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ulocbuilder.h
16.69 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ulocdata.h
11.3 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
umachine.h
14.59 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
umisc.h
1.34 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
umsg.h
24.25 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
umutablecptrie.h
8.3 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
unifilt.h
4 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
unifunct.h
4.05 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
unimatch.h
6.1 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
unirepl.h
3.38 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uniset.h
70.4 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
unistr.h
182.08 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
unorm.h
20.55 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
unorm2.h
25.66 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
unum.h
55.16 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
unumberformatter.h
19.68 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
unumberoptions.h
5.23 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
unumberrangeformatter.h
15.35 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
unumsys.h
7.26 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uobject.h
10.66 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
upluralrules.h
8.79 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uregex.h
71.99 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uregion.h
9.81 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ureldatefmt.h
16.98 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
urename.h
141.99 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
urep.h
5.38 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ures.h
36.65 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uscript.h
28.51 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
usearch.h
39.21 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uset.h
63.08 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
usetiter.h
9.63 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ushape.h
18 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
usimplenumberformatter.h
7.31 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uspoof.h
80 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
usprep.h
8.19 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ustdio.h
38.58 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ustream.h
1.89 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ustring.h
72.16 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
ustringtrie.h
3.15 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
utext.h
58.1 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
utf.h
7.87 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
utf16.h
23.35 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
utf32.h
763 bytes
06/06/2025 11:36:00 AM
rw-r--r--
π
utf8.h
30.83 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
utf_old.h
45.8 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
utmscale.h
13.78 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
utrace.h
17.18 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
utrans.h
25.54 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
utypes.h
34.48 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uvernum.h
6.33 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
uversion.h
8.21 KB
06/06/2025 11:36:00 AM
rw-r--r--
π
vtzone.h
20.68 KB
06/06/2025 11:36:00 AM
rw-r--r--
Editing: localebuilder.h
Close
// Β© 2018 and later: Unicode, Inc. and others. // License & terms of use: http://www.unicode.org/copyright.html #ifndef __LOCALEBUILDER_H__ #define __LOCALEBUILDER_H__ #include "unicode/utypes.h" #if U_SHOW_CPLUSPLUS_API #include "unicode/locid.h" #include "unicode/localematcher.h" #include "unicode/stringpiece.h" #include "unicode/uobject.h" /** * \file * \brief C++ API: Builder API for Locale */ U_NAMESPACE_BEGIN class CharString; /** * <code>LocaleBuilder</code> is used to build instances of <code>Locale</code> * from values configured by the setters. Unlike the <code>Locale</code> * constructors, the <code>LocaleBuilder</code> checks if a value configured by a * setter satisfies the syntax requirements defined by the <code>Locale</code> * class. A <code>Locale</code> object created by a <code>LocaleBuilder</code> is * well-formed and can be transformed to a well-formed IETF BCP 47 language tag * without losing information. * * <p>The following example shows how to create a <code>Locale</code> object * with the <code>LocaleBuilder</code>. * <blockquote> * <pre> * UErrorCode status = U_ZERO_ERROR; * Locale aLocale = LocaleBuilder() * .setLanguage("sr") * .setScript("Latn") * .setRegion("RS") * .build(status); * if (U_SUCCESS(status)) { * // ... * } * </pre> * </blockquote> * * <p>LocaleBuilders can be reused; <code>clear()</code> resets all * fields to their default values. * * <p>LocaleBuilder tracks errors in an internal UErrorCode. For all setters, * except setLanguageTag and setLocale, LocaleBuilder will return immediately * if the internal UErrorCode is in error state. * To reset internal state and error code, call clear method. * The setLanguageTag and setLocale method will first clear the internal * UErrorCode, then track the error of the validation of the input parameter * into the internal UErrorCode. * * @stable ICU 64 */ class U_COMMON_API LocaleBuilder : public UObject { public: /** * Constructs an empty LocaleBuilder. The default value of all * fields, extensions, and private use information is the * empty string. * * @stable ICU 64 */ LocaleBuilder(); /** * Destructor * @stable ICU 64 */ virtual ~LocaleBuilder(); /** * Resets the <code>LocaleBuilder</code> to match the provided * <code>locale</code>. Existing state is discarded. * * <p>All fields of the locale must be well-formed. * <p>This method clears the internal UErrorCode. * * @param locale the locale * @return This builder. * * @stable ICU 64 */ LocaleBuilder& setLocale(const Locale& locale); /** * Resets the LocaleBuilder to match the provided IETF BCP 47 language tag. * Discards the existing state. * The empty string causes the builder to be reset, like {@link #clear}. * Legacy language tags (marked as βType: grandfatheredβ in BCP 47) * are converted to their canonical form before being processed. * Otherwise, the <code>language tag</code> must be well-formed, * or else the build() method will later report an U_ILLEGAL_ARGUMENT_ERROR. * * <p>This method clears the internal UErrorCode. * * @param tag the language tag, defined as IETF BCP 47 language tag. * @return This builder. * @stable ICU 64 */ LocaleBuilder& setLanguageTag(StringPiece tag); /** * Sets the language. If <code>language</code> is the empty string, the * language in this <code>LocaleBuilder</code> is removed. Otherwise, the * <code>language</code> must be well-formed, or else the build() method will * later report an U_ILLEGAL_ARGUMENT_ERROR. * * <p>The syntax of language value is defined as * [unicode_language_subtag](http://www.unicode.org/reports/tr35/tr35.html#unicode_language_subtag). * * @param language the language * @return This builder. * @stable ICU 64 */ LocaleBuilder& setLanguage(StringPiece language); /** * Sets the script. If <code>script</code> is the empty string, the script in * this <code>LocaleBuilder</code> is removed. * Otherwise, the <code>script</code> must be well-formed, or else the build() * method will later report an U_ILLEGAL_ARGUMENT_ERROR. * * <p>The script value is a four-letter script code as * [unicode_script_subtag](http://www.unicode.org/reports/tr35/tr35.html#unicode_script_subtag) * defined by ISO 15924 * * @param script the script * @return This builder. * @stable ICU 64 */ LocaleBuilder& setScript(StringPiece script); /** * Sets the region. If region is the empty string, the region in this * <code>LocaleBuilder</code> is removed. Otherwise, the <code>region</code> * must be well-formed, or else the build() method will later report an * U_ILLEGAL_ARGUMENT_ERROR. * * <p>The region value is defined by * [unicode_region_subtag](http://www.unicode.org/reports/tr35/tr35.html#unicode_region_subtag) * as a two-letter ISO 3166 code or a three-digit UN M.49 area code. * * <p>The region value in the <code>Locale</code> created by the * <code>LocaleBuilder</code> is always normalized to upper case. * * @param region the region * @return This builder. * @stable ICU 64 */ LocaleBuilder& setRegion(StringPiece region); /** * Sets the variant. If variant is the empty string, the variant in this * <code>LocaleBuilder</code> is removed. Otherwise, the <code>variant</code> * must be well-formed, or else the build() method will later report an * U_ILLEGAL_ARGUMENT_ERROR. * * <p><b>Note:</b> This method checks if <code>variant</code> * satisfies the * [unicode_variant_subtag](http://www.unicode.org/reports/tr35/tr35.html#unicode_variant_subtag) * syntax requirements, and normalizes the value to lowercase letters. However, * the <code>Locale</code> class does not impose any syntactic * restriction on variant. To set an ill-formed variant, use a Locale constructor. * If there are multiple unicode_variant_subtag, the caller must concatenate * them with '-' as separator (ex: "foobar-fibar"). * * @param variant the variant * @return This builder. * @stable ICU 64 */ LocaleBuilder& setVariant(StringPiece variant); /** * Sets the extension for the given key. If the value is the empty string, * the extension is removed. Otherwise, the <code>key</code> and * <code>value</code> must be well-formed, or else the build() method will * later report an U_ILLEGAL_ARGUMENT_ERROR. * * <p><b>Note:</b> The key ('u') is used for the Unicode locale extension. * Setting a value for this key replaces any existing Unicode locale key/type * pairs with those defined in the extension. * * <p><b>Note:</b> The key ('x') is used for the private use code. To be * well-formed, the value for this key needs only to have subtags of one to * eight alphanumeric characters, not two to eight as in the general case. * * @param key the extension key * @param value the extension value * @return This builder. * @stable ICU 64 */ LocaleBuilder& setExtension(char key, StringPiece value); /** * Sets the Unicode locale keyword type for the given key. If the type * StringPiece is constructed with a nullptr, the keyword is removed. * If the type is the empty string, the keyword is set without type subtags. * Otherwise, the key and type must be well-formed, or else the build() * method will later report an U_ILLEGAL_ARGUMENT_ERROR. * * <p>Keys and types are converted to lower case. * * <p><b>Note</b>:Setting the 'u' extension via {@link #setExtension} * replaces all Unicode locale keywords with those defined in the * extension. * * @param key the Unicode locale key * @param type the Unicode locale type * @return This builder. * @stable ICU 64 */ LocaleBuilder& setUnicodeLocaleKeyword( StringPiece key, StringPiece type); /** * Adds a unicode locale attribute, if not already present, otherwise * has no effect. The attribute must not be empty string and must be * well-formed or U_ILLEGAL_ARGUMENT_ERROR will be set to status * during the build() call. * * @param attribute the attribute * @return This builder. * @stable ICU 64 */ LocaleBuilder& addUnicodeLocaleAttribute(StringPiece attribute); /** * Removes a unicode locale attribute, if present, otherwise has no * effect. The attribute must not be empty string and must be well-formed * or U_ILLEGAL_ARGUMENT_ERROR will be set to status during the build() call. * * <p>Attribute comparison for removal is case-insensitive. * * @param attribute the attribute * @return This builder. * @stable ICU 64 */ LocaleBuilder& removeUnicodeLocaleAttribute(StringPiece attribute); /** * Resets the builder to its initial, empty state. * <p>This method clears the internal UErrorCode. * * @return this builder * @stable ICU 64 */ LocaleBuilder& clear(); /** * Resets the extensions to their initial, empty state. * Language, script, region and variant are unchanged. * * @return this builder * @stable ICU 64 */ LocaleBuilder& clearExtensions(); /** * Returns an instance of <code>Locale</code> created from the fields set * on this builder. * If any set methods or during the build() call require memory allocation * but fail U_MEMORY_ALLOCATION_ERROR will be set to status. * If any of the fields set by the setters are not well-formed, the status * will be set to U_ILLEGAL_ARGUMENT_ERROR. The state of the builder will * not change after the build() call and the caller is free to keep using * the same builder to build more locales. * * @return a new Locale * @stable ICU 64 */ Locale build(UErrorCode& status); /** * Sets the UErrorCode if an error occurred while recording sets. * Preserves older error codes in the outErrorCode. * @param outErrorCode Set to an error code that occurred while setting subtags. * Unchanged if there is no such error or if outErrorCode * already contained an error. * @return true if U_FAILURE(outErrorCode) * @stable ICU 65 */ UBool copyErrorTo(UErrorCode &outErrorCode) const; private: friend class LocaleMatcher::Result; void copyExtensionsFrom(const Locale& src, UErrorCode& errorCode); UErrorCode status_; char language_[9]; char script_[5]; char region_[4]; CharString *variant_; // Pointer not object so we need not #include internal charstr.h. icu::Locale *extensions_; // Pointer not object. Storage for all other fields. }; U_NAMESPACE_END #endif /* U_SHOW_CPLUSPLUS_API */ #endif // __LOCALEBUILDER_H__