OXIESEC PANEL
- Current Dir:
/
/
opt
/
alt
/
libicu71
/
usr
/
include
/
unicode
Server IP: 2a02:4780:11:1594:0:ef5:22d7:a
Upload:
Create Dir:
Name
Size
Modified
Perms
📁
..
-
05/14/2024 03:54:45 PM
rwxr-xr-x
📄
alphaindex.h
26.52 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
appendable.h
8.53 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
basictz.h
9.86 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
brkiter.h
27.81 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
bytestream.h
10.75 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
bytestrie.h
20.77 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
bytestriebuilder.h
7.46 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
calendar.h
105.88 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
caniter.h
7.44 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
casemap.h
25.33 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
char16ptr.h
7.22 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
chariter.h
24.06 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
choicfmt.h
23.97 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
coleitr.h
13.77 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
coll.h
56.26 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
compactdecimalformat.h
6.88 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
curramt.h
3.78 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
currpinf.h
7.3 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
currunit.h
4.02 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
datefmt.h
40.71 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
dbbi.h
1.19 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
dcfmtsym.h
20.61 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
decimfmt.h
87.57 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
docmain.h
7.21 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
dtfmtsym.h
38.21 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
dtintrv.h
3.84 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
dtitvfmt.h
49.27 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
dtitvinf.h
18.63 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
dtptngen.h
28.84 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
dtrule.h
8.69 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
edits.h
20.74 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
enumset.h
2.08 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
errorcode.h
4.84 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
fieldpos.h
8.7 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
filteredbrk.h
5.37 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
fmtable.h
24.43 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
format.h
12.5 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
formattedvalue.h
9.75 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
fpositer.h
3.03 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
gender.h
3.33 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
gregocal.h
31.88 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
icudataver.h
1.02 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
icuplug.h
11.83 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
idna.h
12.7 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
listformatter.h
8.79 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
localebuilder.h
11.08 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
localematcher.h
26.84 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
localpointer.h
19.36 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
locdspnm.h
7.12 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
locid.h
47.66 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
measfmt.h
11.42 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
measunit.h
104.97 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
measure.h
4.33 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
messagepattern.h
33.71 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
msgfmt.h
44.22 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
normalizer2.h
33.66 KB
12/01/2022 11:12:32 AM
rw-r--r--
📄
normlzr.h
30.95 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
nounit.h
2.25 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
numberformatter.h
94.15 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
numberrangeformatter.h
25.19 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
numfmt.h
49.84 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
numsys.h
7.33 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
parseerr.h
3.08 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
parsepos.h
5.57 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
platform.h
28.09 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
plurfmt.h
25.24 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
plurrule.h
20.82 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ptypes.h
3.49 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
putil.h
6.32 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
rbbi.h
28.64 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
rbnf.h
48.85 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
rbtz.h
15.77 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
regex.h
84.36 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
region.h
9.18 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
reldatefmt.h
22.22 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
rep.h
9.37 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
resbund.h
18.08 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
schriter.h
6.36 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
scientificnumberformatter.h
6.43 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
search.h
22.22 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
selfmt.h
14.34 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
simpleformatter.h
12.59 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
simpletz.h
45.64 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
smpdtfmt.h
71.07 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
sortkey.h
11.18 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
std_string.h
1.05 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
strenum.h
9.92 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
stringoptions.h
5.79 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
stringpiece.h
10.05 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
stringtriebuilder.h
15.47 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
stsearch.h
21.41 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
symtable.h
4.27 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
tblcoll.h
36.92 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
timezone.h
43.81 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
tmunit.h
3.4 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
tmutamt.h
4.91 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
tmutfmt.h
7.42 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
translit.h
65.82 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
tzfmt.h
42.93 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
tznames.h
16.85 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
tzrule.h
35.6 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
tztrans.h
6.13 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ubidi.h
89.61 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ubiditransform.h
12.7 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ubrk.h
24.43 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ucal.h
60.68 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ucasemap.h
15.21 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ucat.h
5.35 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uchar.h
144.64 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ucharstrie.h
22.53 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ucharstriebuilder.h
7.47 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uchriter.h
13.42 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uclean.h
11.2 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ucnv.h
83.46 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ucnv_cb.h
6.58 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ucnv_err.h
20.98 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ucnvsel.h
6.19 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ucol.h
61.95 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ucoleitr.h
9.82 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uconfig.h
12.07 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ucpmap.h
5.53 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ucptrie.h
22.5 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ucsdet.h
14.69 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ucurr.h
16.72 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
udat.h
62.4 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
udata.h
15.63 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
udateintervalformat.h
11.93 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
udatpg.h
30.18 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
udisplaycontext.h
5.94 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uenum.h
7.79 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ufieldpositer.h
4.41 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uformattable.h
10.97 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uformattedvalue.h
12.3 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ugender.h
2.06 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uidna.h
33.43 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uiter.h
22.75 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uldnames.h
10.48 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ulistformatter.h
10.78 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uloc.h
54.63 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ulocdata.h
11.3 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
umachine.h
16.05 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
umisc.h
1.33 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
umsg.h
24.25 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
umutablecptrie.h
8.29 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
unifilt.h
4 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
unifunct.h
4.05 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
unimatch.h
6.1 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
unirepl.h
3.38 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uniset.h
66.46 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
unistr.h
170.53 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
unorm.h
20.55 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
unorm2.h
24.68 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
unounclass.h
735 bytes
12/01/2022 11:12:33 AM
rw-r--r--
📄
unum.h
55.31 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
unumberformatter.h
30.28 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
unumberrangeformatter.h
15.37 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
unumsys.h
7.26 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uobject.h
10.68 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
upluralrules.h
8.79 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uregex.h
71.99 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uregion.h
9.81 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ureldatefmt.h
17.04 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
urename.h
135 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
urep.h
5.38 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ures.h
36.54 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uscript.h
27.63 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
usearch.h
39.21 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uset.h
44.29 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
usetiter.h
9.68 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ushape.h
18 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uspoof.h
65.84 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
usprep.h
8.19 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ustdio.h
38.56 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ustream.h
1.89 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ustring.h
72.36 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
ustringtrie.h
3.15 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
utext.h
58.08 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
utf.h
7.87 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
utf16.h
23.35 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
utf32.h
763 bytes
12/01/2022 11:12:33 AM
rw-r--r--
📄
utf8.h
30.83 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
utf_old.h
45.83 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
utmscale.h
13.78 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
utrace.h
17.18 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
utrans.h
25.54 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
utypes.h
31.06 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uvernum.h
6.68 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
uversion.h
5.99 KB
12/01/2022 11:12:33 AM
rw-r--r--
📄
vtzone.h
20.74 KB
12/01/2022 11:12:33 AM
rw-r--r--
Editing: simpleformatter.h
Close
// © 2016 and later: Unicode, Inc. and others. // License & terms of use: http://www.unicode.org/copyright.html /* ****************************************************************************** * Copyright (C) 2014-2016, International Business Machines * Corporation and others. All Rights Reserved. ****************************************************************************** * simpleformatter.h */ #ifndef __SIMPLEFORMATTER_H__ #define __SIMPLEFORMATTER_H__ /** * \file * \brief C++ API: Simple formatter, minimal subset of MessageFormat. */ #include "unicode/utypes.h" #if U_SHOW_CPLUSPLUS_API #include "unicode/unistr.h" U_NAMESPACE_BEGIN // Forward declaration: namespace number { namespace impl { class SimpleModifier; } } /** * Formats simple patterns like "{1} was born in {0}". * Minimal subset of MessageFormat; fast, simple, minimal dependencies. * Supports only numbered arguments with no type nor style parameters, * and formats only string values. * Quoting via ASCII apostrophe compatible with ICU MessageFormat default behavior. * * Factory methods set error codes for syntax errors * and for too few or too many arguments/placeholders. * * SimpleFormatter objects are thread-safe except for assignment and applying new patterns. * * Example: * <pre> * UErrorCode errorCode = U_ZERO_ERROR; * SimpleFormatter fmt("{1} '{born}' in {0}", errorCode); * UnicodeString result; * * // Output: "paul {born} in england" * fmt.format("england", "paul", result, errorCode); * </pre> * * This class is not intended for public subclassing. * * @see MessageFormat * @see UMessagePatternApostropheMode * @stable ICU 57 */ class U_COMMON_API SimpleFormatter U_FINAL : public UMemory { public: /** * Default constructor. * @stable ICU 57 */ SimpleFormatter() : compiledPattern((char16_t)0) {} /** * Constructs a formatter from the pattern string. * * @param pattern The pattern string. * @param errorCode ICU error code in/out parameter. * Must fulfill U_SUCCESS before the function call. * Set to U_ILLEGAL_ARGUMENT_ERROR for bad argument syntax. * @stable ICU 57 */ SimpleFormatter(const UnicodeString& pattern, UErrorCode &errorCode) { applyPattern(pattern, errorCode); } /** * Constructs a formatter from the pattern string. * The number of arguments checked against the given limits is the * highest argument number plus one, not the number of occurrences of arguments. * * @param pattern The pattern string. * @param min The pattern must have at least this many arguments. * @param max The pattern must have at most this many arguments. * @param errorCode ICU error code in/out parameter. * Must fulfill U_SUCCESS before the function call. * Set to U_ILLEGAL_ARGUMENT_ERROR for bad argument syntax and * too few or too many arguments. * @stable ICU 57 */ SimpleFormatter(const UnicodeString& pattern, int32_t min, int32_t max, UErrorCode &errorCode) { applyPatternMinMaxArguments(pattern, min, max, errorCode); } /** * Copy constructor. * @stable ICU 57 */ SimpleFormatter(const SimpleFormatter& other) : compiledPattern(other.compiledPattern) {} /** * Assignment operator. * @stable ICU 57 */ SimpleFormatter &operator=(const SimpleFormatter& other); /** * Destructor. * @stable ICU 57 */ ~SimpleFormatter(); /** * Changes this object according to the new pattern. * * @param pattern The pattern string. * @param errorCode ICU error code in/out parameter. * Must fulfill U_SUCCESS before the function call. * Set to U_ILLEGAL_ARGUMENT_ERROR for bad argument syntax. * @return true if U_SUCCESS(errorCode). * @stable ICU 57 */ UBool applyPattern(const UnicodeString &pattern, UErrorCode &errorCode) { return applyPatternMinMaxArguments(pattern, 0, INT32_MAX, errorCode); } /** * Changes this object according to the new pattern. * The number of arguments checked against the given limits is the * highest argument number plus one, not the number of occurrences of arguments. * * @param pattern The pattern string. * @param min The pattern must have at least this many arguments. * @param max The pattern must have at most this many arguments. * @param errorCode ICU error code in/out parameter. * Must fulfill U_SUCCESS before the function call. * Set to U_ILLEGAL_ARGUMENT_ERROR for bad argument syntax and * too few or too many arguments. * @return true if U_SUCCESS(errorCode). * @stable ICU 57 */ UBool applyPatternMinMaxArguments(const UnicodeString &pattern, int32_t min, int32_t max, UErrorCode &errorCode); /** * @return The max argument number + 1. * @stable ICU 57 */ int32_t getArgumentLimit() const { return getArgumentLimit(compiledPattern.getBuffer(), compiledPattern.length()); } /** * Formats the given value, appending to the appendTo builder. * The argument value must not be the same object as appendTo. * getArgumentLimit() must be at most 1. * * @param value0 Value for argument {0}. * @param appendTo Gets the formatted pattern and value appended. * @param errorCode ICU error code in/out parameter. * Must fulfill U_SUCCESS before the function call. * @return appendTo * @stable ICU 57 */ UnicodeString &format( const UnicodeString &value0, UnicodeString &appendTo, UErrorCode &errorCode) const; /** * Formats the given values, appending to the appendTo builder. * An argument value must not be the same object as appendTo. * getArgumentLimit() must be at most 2. * * @param value0 Value for argument {0}. * @param value1 Value for argument {1}. * @param appendTo Gets the formatted pattern and values appended. * @param errorCode ICU error code in/out parameter. * Must fulfill U_SUCCESS before the function call. * @return appendTo * @stable ICU 57 */ UnicodeString &format( const UnicodeString &value0, const UnicodeString &value1, UnicodeString &appendTo, UErrorCode &errorCode) const; /** * Formats the given values, appending to the appendTo builder. * An argument value must not be the same object as appendTo. * getArgumentLimit() must be at most 3. * * @param value0 Value for argument {0}. * @param value1 Value for argument {1}. * @param value2 Value for argument {2}. * @param appendTo Gets the formatted pattern and values appended. * @param errorCode ICU error code in/out parameter. * Must fulfill U_SUCCESS before the function call. * @return appendTo * @stable ICU 57 */ UnicodeString &format( const UnicodeString &value0, const UnicodeString &value1, const UnicodeString &value2, UnicodeString &appendTo, UErrorCode &errorCode) const; /** * Formats the given values, appending to the appendTo string. * * @param values The argument values. * An argument value must not be the same object as appendTo. * Can be NULL if valuesLength==getArgumentLimit()==0. * @param valuesLength The length of the values array. * Must be at least getArgumentLimit(). * @param appendTo Gets the formatted pattern and values appended. * @param offsets offsets[i] receives the offset of where * values[i] replaced pattern argument {i}. * Can be shorter or longer than values. Can be NULL if offsetsLength==0. * If there is no {i} in the pattern, then offsets[i] is set to -1. * @param offsetsLength The length of the offsets array. * @param errorCode ICU error code in/out parameter. * Must fulfill U_SUCCESS before the function call. * @return appendTo * @stable ICU 57 */ UnicodeString &formatAndAppend( const UnicodeString *const *values, int32_t valuesLength, UnicodeString &appendTo, int32_t *offsets, int32_t offsetsLength, UErrorCode &errorCode) const; /** * Formats the given values, replacing the contents of the result string. * May optimize by actually appending to the result if it is the same object * as the value corresponding to the initial argument in the pattern. * * @param values The argument values. * An argument value may be the same object as result. * Can be NULL if valuesLength==getArgumentLimit()==0. * @param valuesLength The length of the values array. * Must be at least getArgumentLimit(). * @param result Gets its contents replaced by the formatted pattern and values. * @param offsets offsets[i] receives the offset of where * values[i] replaced pattern argument {i}. * Can be shorter or longer than values. Can be NULL if offsetsLength==0. * If there is no {i} in the pattern, then offsets[i] is set to -1. * @param offsetsLength The length of the offsets array. * @param errorCode ICU error code in/out parameter. * Must fulfill U_SUCCESS before the function call. * @return result * @stable ICU 57 */ UnicodeString &formatAndReplace( const UnicodeString *const *values, int32_t valuesLength, UnicodeString &result, int32_t *offsets, int32_t offsetsLength, UErrorCode &errorCode) const; /** * Returns the pattern text with none of the arguments. * Like formatting with all-empty string values. * @stable ICU 57 */ UnicodeString getTextWithNoArguments() const { return getTextWithNoArguments( compiledPattern.getBuffer(), compiledPattern.length(), nullptr, 0); } #ifndef U_HIDE_INTERNAL_API /** * Returns the pattern text with none of the arguments. * Like formatting with all-empty string values. * * TODO(ICU-20406): Replace this with an Iterator interface. * * @param offsets offsets[i] receives the offset of where {i} was located * before it was replaced by an empty string. * For example, "a{0}b{1}" produces offset 1 for i=0 and 2 for i=1. * Can be nullptr if offsetsLength==0. * If there is no {i} in the pattern, then offsets[i] is set to -1. * @param offsetsLength The length of the offsets array. * * @internal */ UnicodeString getTextWithNoArguments(int32_t *offsets, int32_t offsetsLength) const { return getTextWithNoArguments( compiledPattern.getBuffer(), compiledPattern.length(), offsets, offsetsLength); } #endif // U_HIDE_INTERNAL_API private: /** * Binary representation of the compiled pattern. * Index 0: One more than the highest argument number. * Followed by zero or more arguments or literal-text segments. * * An argument is stored as its number, less than ARG_NUM_LIMIT. * A literal-text segment is stored as its length (at least 1) offset by ARG_NUM_LIMIT, * followed by that many chars. */ UnicodeString compiledPattern; static inline int32_t getArgumentLimit(const char16_t *compiledPattern, int32_t compiledPatternLength) { return compiledPatternLength == 0 ? 0 : compiledPattern[0]; } static UnicodeString getTextWithNoArguments( const char16_t *compiledPattern, int32_t compiledPatternLength, int32_t *offsets, int32_t offsetsLength); static UnicodeString &format( const char16_t *compiledPattern, int32_t compiledPatternLength, const UnicodeString *const *values, UnicodeString &result, const UnicodeString *resultCopy, UBool forbidResultAsValue, int32_t *offsets, int32_t offsetsLength, UErrorCode &errorCode); // Give access to internals to SimpleModifier for number formatting friend class number::impl::SimpleModifier; }; U_NAMESPACE_END #endif /* U_SHOW_CPLUSPLUS_API */ #endif // __SIMPLEFORMATTER_H__