Linux sagir-us1.hostever.us 5.14.0-570.51.1.el9_6.x86_64 #1 SMP PREEMPT_DYNAMIC Wed Oct 8 09:41:34 EDT 2025 x86_64
LiteSpeed
Server IP : 104.247.108.91 & Your IP : 216.73.216.105
Domains : 74 Domain
User : georgeto
Terminal
Auto Root
Create File
Create Folder
Localroot Suggester
Backdoor Destroyer
Readme
/
usr /
local /
apps /
include /
unicode /
Delete
Unzip
Name
Size
Permission
Date
Action
alphaindex.h
26.25
KB
-rw-r--r--
2019-10-10 05:03
appendable.h
8.38
KB
-rw-r--r--
2019-10-10 05:03
basictz.h
8.85
KB
-rw-r--r--
2019-10-10 05:03
brkiter.h
27.62
KB
-rw-r--r--
2019-10-10 05:03
bytestream.h
9.28
KB
-rw-r--r--
2019-10-10 05:03
bytestrie.h
19.27
KB
-rw-r--r--
2019-10-10 05:03
bytestriebuilder.h
7.11
KB
-rw-r--r--
2019-10-10 05:03
calendar.h
105.38
KB
-rw-r--r--
2019-10-10 05:03
caniter.h
7.36
KB
-rw-r--r--
2019-10-10 05:03
chariter.h
23.83
KB
-rw-r--r--
2019-10-10 05:03
choicfmt.h
23.86
KB
-rw-r--r--
2019-10-10 05:03
coleitr.h
13.69
KB
-rw-r--r--
2019-10-10 05:03
coll.h
55.59
KB
-rw-r--r--
2019-10-10 05:03
compactdecimalformat.h
16.59
KB
-rw-r--r--
2019-10-10 05:03
curramt.h
3.69
KB
-rw-r--r--
2019-10-10 05:03
currpinf.h
7.09
KB
-rw-r--r--
2019-10-10 05:03
currunit.h
2.93
KB
-rw-r--r--
2019-10-10 05:03
datefmt.h
40.19
KB
-rw-r--r--
2019-10-10 05:03
dbbi.h
1.12
KB
-rw-r--r--
2019-10-10 05:03
dcfmtsym.h
16.58
KB
-rw-r--r--
2019-10-10 05:03
decimfmt.h
90.64
KB
-rw-r--r--
2019-10-10 05:03
docmain.h
6.42
KB
-rw-r--r--
2019-10-10 05:03
dtfmtsym.h
37.61
KB
-rw-r--r--
2019-10-10 05:03
dtintrv.h
3.77
KB
-rw-r--r--
2019-10-10 05:03
dtitvfmt.h
42.88
KB
-rw-r--r--
2019-10-10 05:03
dtitvinf.h
18.63
KB
-rw-r--r--
2019-10-10 05:03
dtptngen.h
23.54
KB
-rw-r--r--
2019-10-10 05:03
dtrule.h
8.63
KB
-rw-r--r--
2019-10-10 05:03
enumset.h
2.07
KB
-rw-r--r--
2019-10-10 05:03
errorcode.h
4.79
KB
-rw-r--r--
2019-10-10 05:03
fieldpos.h
8.64
KB
-rw-r--r--
2019-10-10 05:03
filteredbrk.h
4.29
KB
-rw-r--r--
2019-10-10 05:03
fmtable.h
24.4
KB
-rw-r--r--
2019-10-10 05:03
format.h
12.45
KB
-rw-r--r--
2019-10-10 05:03
fpositer.h
2.99
KB
-rw-r--r--
2019-10-10 05:03
gender.h
3.19
KB
-rw-r--r--
2019-10-10 05:03
gregocal.h
31.58
KB
-rw-r--r--
2019-10-10 05:03
icudataver.h
1.04
KB
-rw-r--r--
2019-10-10 05:03
icuplug.h
11.87
KB
-rw-r--r--
2019-10-10 05:03
idna.h
12.65
KB
-rw-r--r--
2019-10-10 05:03
listformatter.h
4.85
KB
-rw-r--r--
2019-10-10 05:03
localpointer.h
18.19
KB
-rw-r--r--
2019-10-10 05:03
locdspnm.h
7.04
KB
-rw-r--r--
2019-10-10 05:03
locid.h
31.42
KB
-rw-r--r--
2019-10-10 05:03
measfmt.h
11.31
KB
-rw-r--r--
2019-10-10 05:03
measunit.h
38.43
KB
-rw-r--r--
2019-10-10 05:03
measure.h
4.27
KB
-rw-r--r--
2019-10-10 05:03
messagepattern.h
33.66
KB
-rw-r--r--
2019-10-10 05:03
msgfmt.h
43.17
KB
-rw-r--r--
2019-10-10 05:03
normalizer2.h
28.29
KB
-rw-r--r--
2019-10-10 05:03
normlzr.h
30.72
KB
-rw-r--r--
2019-10-10 05:03
numfmt.h
45.98
KB
-rw-r--r--
2019-10-10 05:03
numsys.h
6.74
KB
-rw-r--r--
2019-10-10 05:03
parseerr.h
3.09
KB
-rw-r--r--
2019-10-10 05:03
parsepos.h
5.46
KB
-rw-r--r--
2019-10-10 05:03
platform.h
27.25
KB
-rw-r--r--
2019-10-10 05:03
plurfmt.h
25.67
KB
-rw-r--r--
2019-10-10 05:03
plurrule.h
17.28
KB
-rw-r--r--
2019-10-10 05:03
ptypes.h
3.48
KB
-rw-r--r--
2019-10-10 05:03
putil.h
6.35
KB
-rw-r--r--
2019-10-10 05:03
rbbi.h
27.78
KB
-rw-r--r--
2019-10-10 05:03
rbnf.h
47.01
KB
-rw-r--r--
2019-10-10 05:03
rbtz.h
15.48
KB
-rw-r--r--
2019-10-10 05:03
regex.h
84.88
KB
-rw-r--r--
2019-10-10 05:03
region.h
9.13
KB
-rw-r--r--
2019-10-10 05:03
reldatefmt.h
14.34
KB
-rw-r--r--
2019-10-10 05:03
rep.h
9.5
KB
-rw-r--r--
2019-10-10 05:03
resbund.h
18.01
KB
-rw-r--r--
2019-10-10 05:03
schriter.h
6.27
KB
-rw-r--r--
2019-10-10 05:03
scientificnumberformatter.h
6.6
KB
-rw-r--r--
2019-10-10 05:03
search.h
22.22
KB
-rw-r--r--
2019-10-10 05:03
selfmt.h
14.25
KB
-rw-r--r--
2019-10-10 05:03
simpleformatter.h
11.26
KB
-rw-r--r--
2019-10-10 05:03
simpletz.h
45.25
KB
-rw-r--r--
2019-10-10 05:03
smpdtfmt.h
69.73
KB
-rw-r--r--
2019-10-10 05:03
sortkey.h
11.13
KB
-rw-r--r--
2019-10-10 05:03
std_string.h
1
KB
-rw-r--r--
2019-10-10 05:03
strenum.h
10.04
KB
-rw-r--r--
2019-10-10 05:03
stringpiece.h
6.49
KB
-rw-r--r--
2019-10-10 05:03
stringtriebuilder.h
15.17
KB
-rw-r--r--
2019-10-10 05:03
stsearch.h
21.3
KB
-rw-r--r--
2019-10-10 05:03
symtable.h
4.22
KB
-rw-r--r--
2019-10-10 05:03
tblcoll.h
36.37
KB
-rw-r--r--
2019-10-10 05:03
timezone.h
40.83
KB
-rw-r--r--
2019-10-10 05:03
tmunit.h
3.3
KB
-rw-r--r--
2019-10-10 05:03
tmutamt.h
4.81
KB
-rw-r--r--
2019-10-10 05:03
tmutfmt.h
7.8
KB
-rw-r--r--
2019-10-10 05:03
translit.h
54.53
KB
-rw-r--r--
2019-10-10 05:03
tzfmt.h
42.81
KB
-rw-r--r--
2019-10-10 05:03
tznames.h
16.86
KB
-rw-r--r--
2019-10-10 05:03
tzrule.h
35.33
KB
-rw-r--r--
2019-10-10 05:03
tztrans.h
6.08
KB
-rw-r--r--
2019-10-10 05:03
ubidi.h
89.14
KB
-rw-r--r--
2019-10-10 05:03
ubiditransform.h
12.76
KB
-rw-r--r--
2019-10-10 05:03
ubrk.h
20.74
KB
-rw-r--r--
2019-10-10 05:03
ucal.h
54.55
KB
-rw-r--r--
2019-10-10 05:03
ucasemap.h
16.57
KB
-rw-r--r--
2019-10-10 05:03
ucat.h
5.37
KB
-rw-r--r--
2019-10-10 05:03
uchar.h
130.91
KB
-rw-r--r--
2019-10-10 05:03
ucharstrie.h
20.92
KB
-rw-r--r--
2019-10-10 05:03
ucharstriebuilder.h
7.13
KB
-rw-r--r--
2019-10-10 05:03
uchriter.h
12.95
KB
-rw-r--r--
2019-10-10 05:03
uclean.h
11.15
KB
-rw-r--r--
2019-10-10 05:03
ucnv.h
83.07
KB
-rw-r--r--
2019-10-10 05:03
ucnv_cb.h
6.6
KB
-rw-r--r--
2019-10-10 05:03
ucnv_err.h
21
KB
-rw-r--r--
2019-10-10 05:03
ucnvsel.h
6.15
KB
-rw-r--r--
2019-10-10 05:03
ucol.h
61.36
KB
-rw-r--r--
2019-10-10 05:03
ucoleitr.h
9.46
KB
-rw-r--r--
2019-10-10 05:03
uconfig.h
11.88
KB
-rw-r--r--
2019-10-10 05:03
ucsdet.h
14.47
KB
-rw-r--r--
2019-10-10 05:03
ucurr.h
15.16
KB
-rw-r--r--
2019-10-10 05:03
udat.h
60.25
KB
-rw-r--r--
2019-10-10 05:03
udata.h
15.55
KB
-rw-r--r--
2019-10-10 05:03
udateintervalformat.h
6.8
KB
-rw-r--r--
2019-10-10 05:03
udatpg.h
24.12
KB
-rw-r--r--
2019-10-10 05:03
udisplaycontext.h
6
KB
-rw-r--r--
2019-10-10 05:03
uenum.h
7.88
KB
-rw-r--r--
2019-10-10 05:03
ufieldpositer.h
4.37
KB
-rw-r--r--
2019-10-10 05:03
uformattable.h
10.94
KB
-rw-r--r--
2019-10-10 05:03
ugender.h
2.01
KB
-rw-r--r--
2019-10-10 05:03
uidna.h
33.38
KB
-rw-r--r--
2019-10-10 05:03
uiter.h
22.79
KB
-rw-r--r--
2019-10-10 05:03
uldnames.h
10.46
KB
-rw-r--r--
2019-10-10 05:03
ulistformatter.h
4.55
KB
-rw-r--r--
2019-10-10 05:03
uloc.h
50.07
KB
-rw-r--r--
2019-10-10 05:03
ulocdata.h
11.27
KB
-rw-r--r--
2019-10-10 05:03
umachine.h
11.56
KB
-rw-r--r--
2019-10-10 05:03
umisc.h
1.35
KB
-rw-r--r--
2019-10-10 05:03
umsg.h
24.24
KB
-rw-r--r--
2019-10-10 05:03
unifilt.h
3.64
KB
-rw-r--r--
2019-10-10 05:03
unifunct.h
3.99
KB
-rw-r--r--
2019-10-10 05:03
unimatch.h
6.05
KB
-rw-r--r--
2019-10-10 05:03
unirepl.h
3.33
KB
-rw-r--r--
2019-10-10 05:03
uniset.h
63.99
KB
-rw-r--r--
2019-10-10 05:03
unistr.h
169.99
KB
-rw-r--r--
2019-10-10 05:03
unorm.h
20.43
KB
-rw-r--r--
2019-10-10 05:03
unorm2.h
25.23
KB
-rw-r--r--
2019-10-10 05:03
unum.h
50.01
KB
-rw-r--r--
2019-10-10 05:03
unumsys.h
7.15
KB
-rw-r--r--
2019-10-10 05:03
uobject.h
10.73
KB
-rw-r--r--
2019-10-10 05:03
upluralrules.h
4.74
KB
-rw-r--r--
2019-10-10 05:03
uregex.h
72.07
KB
-rw-r--r--
2019-10-10 05:03
uregion.h
9.84
KB
-rw-r--r--
2019-10-10 05:03
ureldatefmt.h
12.31
KB
-rw-r--r--
2019-10-10 05:03
urename.h
124.22
KB
-rw-r--r--
2019-10-10 05:03
urep.h
5.39
KB
-rw-r--r--
2019-10-10 05:03
ures.h
36.53
KB
-rw-r--r--
2019-10-10 05:03
uscript.h
25.66
KB
-rw-r--r--
2019-10-10 05:03
usearch.h
38.15
KB
-rw-r--r--
2019-10-10 05:03
uset.h
39.92
KB
-rw-r--r--
2019-10-10 05:03
usetiter.h
9.5
KB
-rw-r--r--
2019-10-10 05:03
ushape.h
18.01
KB
-rw-r--r--
2019-10-10 05:03
uspoof.h
65.05
KB
-rw-r--r--
2019-10-10 05:03
usprep.h
8.14
KB
-rw-r--r--
2019-10-10 05:03
ustdio.h
38.55
KB
-rw-r--r--
2019-10-10 05:03
ustream.h
1.92
KB
-rw-r--r--
2019-10-10 05:03
ustring.h
72.81
KB
-rw-r--r--
2019-10-10 05:03
ustringtrie.h
3.16
KB
-rw-r--r--
2019-10-10 05:03
utext.h
58.09
KB
-rw-r--r--
2019-10-10 05:03
utf.h
7.76
KB
-rw-r--r--
2019-10-10 05:03
utf16.h
18.75
KB
-rw-r--r--
2019-10-10 05:03
utf32.h
777
B
-rw-r--r--
2019-10-10 05:03
utf8.h
27.74
KB
-rw-r--r--
2019-10-10 05:03
utf_old.h
42.62
KB
-rw-r--r--
2019-10-10 05:03
utmscale.h
13.49
KB
-rw-r--r--
2019-10-10 05:03
utrace.h
13.9
KB
-rw-r--r--
2019-10-10 05:03
utrans.h
25.54
KB
-rw-r--r--
2019-10-10 05:03
utypes.h
29.92
KB
-rw-r--r--
2019-10-10 05:03
uvernum.h
5.71
KB
-rw-r--r--
2019-10-10 05:03
uversion.h
6.42
KB
-rw-r--r--
2019-10-10 05:03
vtzone.h
20.18
KB
-rw-r--r--
2019-10-10 05:03
Save
Rename
// Copyright (C) 2016 and later: Unicode, Inc. and others. // License & terms of use: http://www.unicode.org/copyright.html /******************************************************************** * COPYRIGHT: * Copyright (c) 1997-2011, International Business Machines Corporation and * others. All Rights Reserved. * Copyright (C) 2010 , Yahoo! Inc. ******************************************************************** * * file name: umsg.h * encoding: US-ASCII * tab size: 8 (not used) * indentation:4 * * Change history: * * 08/5/2001 Ram Added C wrappers for C++ API. ********************************************************************/ #ifndef UMSG_H #define UMSG_H #include "unicode/utypes.h" #if !UCONFIG_NO_FORMATTING #include "unicode/localpointer.h" #include "unicode/uloc.h" #include "unicode/parseerr.h" #include <stdarg.h> /** * \file * \brief C API: MessageFormat * * <h2>MessageFormat C API </h2> * * <p>MessageFormat prepares strings for display to users, * with optional arguments (variables/placeholders). * The arguments can occur in any order, which is necessary for translation * into languages with different grammars. * * <p>The opaque UMessageFormat type is a thin C wrapper around * a C++ MessageFormat. It is constructed from a <em>pattern</em> string * with arguments in {curly braces} which will be replaced by formatted values. * * <p>Currently, the C API supports only numbered arguments. * * <p>For details about the pattern syntax and behavior, * especially about the ASCII apostrophe vs. the * real apostrophe (single quote) character \htmlonly’\endhtmlonly (U+2019), * see the C++ MessageFormat class documentation. * * <p>Here are some examples of C API usage: * Example 1: * <pre> * \code * UChar *result, *tzID, *str; * UChar pattern[100]; * int32_t resultLengthOut, resultlength; * UCalendar *cal; * UDate d1; * UDateFormat *def1; * UErrorCode status = U_ZERO_ERROR; * * str=(UChar*)malloc(sizeof(UChar) * (strlen("disturbance in force") +1)); * u_uastrcpy(str, "disturbance in force"); * tzID=(UChar*)malloc(sizeof(UChar) * 4); * u_uastrcpy(tzID, "PST"); * cal=ucal_open(tzID, u_strlen(tzID), "en_US", UCAL_TRADITIONAL, &status); * ucal_setDateTime(cal, 1999, UCAL_MARCH, 18, 0, 0, 0, &status); * d1=ucal_getMillis(cal, &status); * u_uastrcpy(pattern, "On {0, date, long}, there was a {1} on planet {2,number,integer}"); * resultlength=0; * resultLengthOut=u_formatMessage( "en_US", pattern, u_strlen(pattern), NULL, resultlength, &status, d1, str, 7); * if(status==U_BUFFER_OVERFLOW_ERROR){ * status=U_ZERO_ERROR; * resultlength=resultLengthOut+1; * result=(UChar*)realloc(result, sizeof(UChar) * resultlength); * u_formatMessage( "en_US", pattern, u_strlen(pattern), result, resultlength, &status, d1, str, 7); * } * printf("%s\n", austrdup(result) );//austrdup( a function used to convert UChar* to char*) * //output>: "On March 18, 1999, there was a disturbance in force on planet 7 * \endcode * </pre> * Typically, the message format will come from resources, and the * arguments will be dynamically set at runtime. * <P> * Example 2: * <pre> * \code * UChar* str; * UErrorCode status = U_ZERO_ERROR; * UChar *result; * UChar pattern[100]; * int32_t resultlength, resultLengthOut, i; * double testArgs= { 100.0, 1.0, 0.0}; * * str=(UChar*)malloc(sizeof(UChar) * 10); * u_uastrcpy(str, "MyDisk"); * u_uastrcpy(pattern, "The disk {1} contains {0,choice,0#no files|1#one file|1<{0,number,integer} files}"); * for(i=0; i<3; i++){ * resultlength=0; * resultLengthOut=u_formatMessage( "en_US", pattern, u_strlen(pattern), NULL, resultlength, &status, testArgs[i], str); * if(status==U_BUFFER_OVERFLOW_ERROR){ * status=U_ZERO_ERROR; * resultlength=resultLengthOut+1; * result=(UChar*)malloc(sizeof(UChar) * resultlength); * u_formatMessage( "en_US", pattern, u_strlen(pattern), result, resultlength, &status, testArgs[i], str); * } * printf("%s\n", austrdup(result) ); //austrdup( a function used to convert UChar* to char*) * free(result); * } * // output, with different testArgs: * // output: The disk "MyDisk" contains 100 files. * // output: The disk "MyDisk" contains one file. * // output: The disk "MyDisk" contains no files. * \endcode * </pre> * * * Example 3: * <pre> * \code * UChar* str; * UChar* str1; * UErrorCode status = U_ZERO_ERROR; * UChar *result; * UChar pattern[100]; * UChar expected[100]; * int32_t resultlength,resultLengthOut; * str=(UChar*)malloc(sizeof(UChar) * 25); * u_uastrcpy(str, "Kirti"); * str1=(UChar*)malloc(sizeof(UChar) * 25); * u_uastrcpy(str1, "female"); * log_verbose("Testing message format with Select test #1\n:"); * u_uastrcpy(pattern, "{0} est {1, select, female {all\\u00E9e} other {all\\u00E9}} \\u00E0 Paris."); * u_uastrcpy(expected, "Kirti est all\\u00E9e \\u00E0 Paris."); * resultlength=0; * resultLengthOut=u_formatMessage( "fr", pattern, u_strlen(pattern), NULL, resultlength, &status, str , str1); * if(status==U_BUFFER_OVERFLOW_ERROR) * { * status=U_ZERO_ERROR; * resultlength=resultLengthOut+1; * result=(UChar*)malloc(sizeof(UChar) * resultlength); * u_formatMessage( "fr", pattern, u_strlen(pattern), result, resultlength, &status, str , str1); * if(u_strcmp(result, expected)==0) * log_verbose("PASS: MessagFormat successful on Select test#1\n"); * else{ * log_err("FAIL: Error in MessageFormat on Select test#1\n GOT %s EXPECTED %s\n", austrdup(result), * austrdup(expected) ); * } * free(result); * } * \endcode * </pre> */ /** * Format a message for a locale. * This function may perform re-ordering of the arguments depending on the * locale. For all numeric arguments, double is assumed unless the type is * explicitly integer. All choice format arguments must be of type double. * @param locale The locale for which the message will be formatted * @param pattern The pattern specifying the message's format * @param patternLength The length of pattern * @param result A pointer to a buffer to receive the formatted message. * @param resultLength The maximum size of result. * @param status A pointer to an UErrorCode to receive any errors * @param ... A variable-length argument list containing the arguments specified * in pattern. * @return The total buffer size needed; if greater than resultLength, the * output was truncated. * @see u_parseMessage * @stable ICU 2.0 */ U_STABLE int32_t U_EXPORT2 u_formatMessage(const char *locale, const UChar *pattern, int32_t patternLength, UChar *result, int32_t resultLength, UErrorCode *status, ...); /** * Format a message for a locale. * This function may perform re-ordering of the arguments depending on the * locale. For all numeric arguments, double is assumed unless the type is * explicitly integer. All choice format arguments must be of type double. * @param locale The locale for which the message will be formatted * @param pattern The pattern specifying the message's format * @param patternLength The length of pattern * @param result A pointer to a buffer to receive the formatted message. * @param resultLength The maximum size of result. * @param ap A variable-length argument list containing the arguments specified * @param status A pointer to an UErrorCode to receive any errors * in pattern. * @return The total buffer size needed; if greater than resultLength, the * output was truncated. * @see u_parseMessage * @stable ICU 2.0 */ U_STABLE int32_t U_EXPORT2 u_vformatMessage( const char *locale, const UChar *pattern, int32_t patternLength, UChar *result, int32_t resultLength, va_list ap, UErrorCode *status); /** * Parse a message. * For numeric arguments, this function will always use doubles. Integer types * should not be passed. * This function is not able to parse all output from {@link #u_formatMessage }. * @param locale The locale for which the message is formatted * @param pattern The pattern specifying the message's format * @param patternLength The length of pattern * @param source The text to parse. * @param sourceLength The length of source, or -1 if null-terminated. * @param status A pointer to an UErrorCode to receive any errors * @param ... A variable-length argument list containing the arguments * specified in pattern. * @see u_formatMessage * @stable ICU 2.0 */ U_STABLE void U_EXPORT2 u_parseMessage( const char *locale, const UChar *pattern, int32_t patternLength, const UChar *source, int32_t sourceLength, UErrorCode *status, ...); /** * Parse a message. * For numeric arguments, this function will always use doubles. Integer types * should not be passed. * This function is not able to parse all output from {@link #u_formatMessage }. * @param locale The locale for which the message is formatted * @param pattern The pattern specifying the message's format * @param patternLength The length of pattern * @param source The text to parse. * @param sourceLength The length of source, or -1 if null-terminated. * @param ap A variable-length argument list containing the arguments * @param status A pointer to an UErrorCode to receive any errors * specified in pattern. * @see u_formatMessage * @stable ICU 2.0 */ U_STABLE void U_EXPORT2 u_vparseMessage(const char *locale, const UChar *pattern, int32_t patternLength, const UChar *source, int32_t sourceLength, va_list ap, UErrorCode *status); /** * Format a message for a locale. * This function may perform re-ordering of the arguments depending on the * locale. For all numeric arguments, double is assumed unless the type is * explicitly integer. All choice format arguments must be of type double. * @param locale The locale for which the message will be formatted * @param pattern The pattern specifying the message's format * @param patternLength The length of pattern * @param result A pointer to a buffer to receive the formatted message. * @param resultLength The maximum size of result. * @param status A pointer to an UErrorCode to receive any errors * @param ... A variable-length argument list containing the arguments specified * in pattern. * @param parseError A pointer to UParseError to receive information about errors * occurred during parsing. * @return The total buffer size needed; if greater than resultLength, the * output was truncated. * @see u_parseMessage * @stable ICU 2.0 */ U_STABLE int32_t U_EXPORT2 u_formatMessageWithError( const char *locale, const UChar *pattern, int32_t patternLength, UChar *result, int32_t resultLength, UParseError *parseError, UErrorCode *status, ...); /** * Format a message for a locale. * This function may perform re-ordering of the arguments depending on the * locale. For all numeric arguments, double is assumed unless the type is * explicitly integer. All choice format arguments must be of type double. * @param locale The locale for which the message will be formatted * @param pattern The pattern specifying the message's format * @param patternLength The length of pattern * @param result A pointer to a buffer to receive the formatted message. * @param resultLength The maximum size of result. * @param parseError A pointer to UParseError to receive information about errors * occurred during parsing. * @param ap A variable-length argument list containing the arguments specified * @param status A pointer to an UErrorCode to receive any errors * in pattern. * @return The total buffer size needed; if greater than resultLength, the * output was truncated. * @stable ICU 2.0 */ U_STABLE int32_t U_EXPORT2 u_vformatMessageWithError( const char *locale, const UChar *pattern, int32_t patternLength, UChar *result, int32_t resultLength, UParseError* parseError, va_list ap, UErrorCode *status); /** * Parse a message. * For numeric arguments, this function will always use doubles. Integer types * should not be passed. * This function is not able to parse all output from {@link #u_formatMessage }. * @param locale The locale for which the message is formatted * @param pattern The pattern specifying the message's format * @param patternLength The length of pattern * @param source The text to parse. * @param sourceLength The length of source, or -1 if null-terminated. * @param parseError A pointer to UParseError to receive information about errors * occurred during parsing. * @param status A pointer to an UErrorCode to receive any errors * @param ... A variable-length argument list containing the arguments * specified in pattern. * @see u_formatMessage * @stable ICU 2.0 */ U_STABLE void U_EXPORT2 u_parseMessageWithError(const char *locale, const UChar *pattern, int32_t patternLength, const UChar *source, int32_t sourceLength, UParseError *parseError, UErrorCode *status, ...); /** * Parse a message. * For numeric arguments, this function will always use doubles. Integer types * should not be passed. * This function is not able to parse all output from {@link #u_formatMessage }. * @param locale The locale for which the message is formatted * @param pattern The pattern specifying the message's format * @param patternLength The length of pattern * @param source The text to parse. * @param sourceLength The length of source, or -1 if null-terminated. * @param ap A variable-length argument list containing the arguments * @param parseError A pointer to UParseError to receive information about errors * occurred during parsing. * @param status A pointer to an UErrorCode to receive any errors * specified in pattern. * @see u_formatMessage * @stable ICU 2.0 */ U_STABLE void U_EXPORT2 u_vparseMessageWithError(const char *locale, const UChar *pattern, int32_t patternLength, const UChar *source, int32_t sourceLength, va_list ap, UParseError *parseError, UErrorCode* status); /*----------------------- New experimental API --------------------------- */ /** * The message format object * @stable ICU 2.0 */ typedef void* UMessageFormat; /** * Open a message formatter with given pattern and for the given locale. * @param pattern A pattern specifying the format to use. * @param patternLength Length of the pattern to use * @param locale The locale for which the messages are formatted. * @param parseError A pointer to UParseError struct to receive any errors * occured during parsing. Can be NULL. * @param status A pointer to an UErrorCode to receive any errors. * @return A pointer to a UMessageFormat to use for formatting * messages, or 0 if an error occurred. * @stable ICU 2.0 */ U_STABLE UMessageFormat* U_EXPORT2 umsg_open( const UChar *pattern, int32_t patternLength, const char *locale, UParseError *parseError, UErrorCode *status); /** * Close a UMessageFormat. * Once closed, a UMessageFormat may no longer be used. * @param format The formatter to close. * @stable ICU 2.0 */ U_STABLE void U_EXPORT2 umsg_close(UMessageFormat* format); #if U_SHOW_CPLUSPLUS_API U_NAMESPACE_BEGIN /** * \class LocalUMessageFormatPointer * "Smart pointer" class, closes a UMessageFormat via umsg_close(). * For most methods see the LocalPointerBase base class. * * @see LocalPointerBase * @see LocalPointer * @stable ICU 4.4 */ U_DEFINE_LOCAL_OPEN_POINTER(LocalUMessageFormatPointer, UMessageFormat, umsg_close); U_NAMESPACE_END #endif /** * Open a copy of a UMessageFormat. * This function performs a deep copy. * @param fmt The formatter to copy * @param status A pointer to an UErrorCode to receive any errors. * @return A pointer to a UDateFormat identical to fmt. * @stable ICU 2.0 */ U_STABLE UMessageFormat U_EXPORT2 umsg_clone(const UMessageFormat *fmt, UErrorCode *status); /** * Sets the locale. This locale is used for fetching default number or date * format information. * @param fmt The formatter to set * @param locale The locale the formatter should use. * @stable ICU 2.0 */ U_STABLE void U_EXPORT2 umsg_setLocale(UMessageFormat *fmt, const char* locale); /** * Gets the locale. This locale is used for fetching default number or date * format information. * @param fmt The formatter to querry * @return the locale. * @stable ICU 2.0 */ U_STABLE const char* U_EXPORT2 umsg_getLocale(const UMessageFormat *fmt); /** * Sets the pattern. * @param fmt The formatter to use * @param pattern The pattern to be applied. * @param patternLength Length of the pattern to use * @param parseError Struct to receive information on position * of error if an error is encountered.Can be NULL. * @param status Output param set to success/failure code on * exit. If the pattern is invalid, this will be * set to a failure result. * @stable ICU 2.0 */ U_STABLE void U_EXPORT2 umsg_applyPattern( UMessageFormat *fmt, const UChar* pattern, int32_t patternLength, UParseError* parseError, UErrorCode* status); /** * Gets the pattern. * @param fmt The formatter to use * @param result A pointer to a buffer to receive the pattern. * @param resultLength The maximum size of result. * @param status Output param set to success/failure code on * exit. If the pattern is invalid, this will be * set to a failure result. * @return the pattern of the format * @stable ICU 2.0 */ U_STABLE int32_t U_EXPORT2 umsg_toPattern(const UMessageFormat *fmt, UChar* result, int32_t resultLength, UErrorCode* status); /** * Format a message for a locale. * This function may perform re-ordering of the arguments depending on the * locale. For all numeric arguments, double is assumed unless the type is * explicitly integer. All choice format arguments must be of type double. * @param fmt The formatter to use * @param result A pointer to a buffer to receive the formatted message. * @param resultLength The maximum size of result. * @param status A pointer to an UErrorCode to receive any errors * @param ... A variable-length argument list containing the arguments * specified in pattern. * @return The total buffer size needed; if greater than resultLength, * the output was truncated. * @stable ICU 2.0 */ U_STABLE int32_t U_EXPORT2 umsg_format( const UMessageFormat *fmt, UChar *result, int32_t resultLength, UErrorCode *status, ...); /** * Format a message for a locale. * This function may perform re-ordering of the arguments depending on the * locale. For all numeric arguments, double is assumed unless the type is * explicitly integer. All choice format arguments must be of type double. * @param fmt The formatter to use * @param result A pointer to a buffer to receive the formatted message. * @param resultLength The maximum size of result. * @param ap A variable-length argument list containing the arguments * @param status A pointer to an UErrorCode to receive any errors * specified in pattern. * @return The total buffer size needed; if greater than resultLength, * the output was truncated. * @stable ICU 2.0 */ U_STABLE int32_t U_EXPORT2 umsg_vformat( const UMessageFormat *fmt, UChar *result, int32_t resultLength, va_list ap, UErrorCode *status); /** * Parse a message. * For numeric arguments, this function will always use doubles. Integer types * should not be passed. * This function is not able to parse all output from {@link #umsg_format }. * @param fmt The formatter to use * @param source The text to parse. * @param sourceLength The length of source, or -1 if null-terminated. * @param count Output param to receive number of elements returned. * @param status A pointer to an UErrorCode to receive any errors * @param ... A variable-length argument list containing the arguments * specified in pattern. * @stable ICU 2.0 */ U_STABLE void U_EXPORT2 umsg_parse( const UMessageFormat *fmt, const UChar *source, int32_t sourceLength, int32_t *count, UErrorCode *status, ...); /** * Parse a message. * For numeric arguments, this function will always use doubles. Integer types * should not be passed. * This function is not able to parse all output from {@link #umsg_format }. * @param fmt The formatter to use * @param source The text to parse. * @param sourceLength The length of source, or -1 if null-terminated. * @param count Output param to receive number of elements returned. * @param ap A variable-length argument list containing the arguments * @param status A pointer to an UErrorCode to receive any errors * specified in pattern. * @see u_formatMessage * @stable ICU 2.0 */ U_STABLE void U_EXPORT2 umsg_vparse(const UMessageFormat *fmt, const UChar *source, int32_t sourceLength, int32_t *count, va_list ap, UErrorCode *status); /** * Convert an 'apostrophe-friendly' pattern into a standard * pattern. Standard patterns treat all apostrophes as * quotes, which is problematic in some languages, e.g. * French, where apostrophe is commonly used. This utility * assumes that only an unpaired apostrophe immediately before * a brace is a true quote. Other unpaired apostrophes are paired, * and the resulting standard pattern string is returned. * * <p><b>Note</b> it is not guaranteed that the returned pattern * is indeed a valid pattern. The only effect is to convert * between patterns having different quoting semantics. * * @param pattern the 'apostrophe-friendly' patttern to convert * @param patternLength the length of pattern, or -1 if unknown and pattern is null-terminated * @param dest the buffer for the result, or NULL if preflight only * @param destCapacity the length of the buffer, or 0 if preflighting * @param ec the error code * @return the length of the resulting text, not including trailing null * if buffer has room for the trailing null, it is provided, otherwise * not * @stable ICU 3.4 */ U_STABLE int32_t U_EXPORT2 umsg_autoQuoteApostrophe(const UChar* pattern, int32_t patternLength, UChar* dest, int32_t destCapacity, UErrorCode* ec); #endif /* #if !UCONFIG_NO_FORMATTING */ #endif