]> git.saurik.com Git - apple/icu.git/blame - icuSources/common/locdspnm.cpp
ICU-64243.0.1.tar.gz
[apple/icu.git] / icuSources / common / locdspnm.cpp
CommitLineData
f3c0d7a5
A
1// © 2016 and later: Unicode, Inc. and others.
2// License & terms of use: http://www.unicode.org/copyright.html
729e4ab9
A
3/*
4*******************************************************************************
2ca993e8 5* Copyright (C) 2010-2016, International Business Machines Corporation and
4388f060 6* others. All Rights Reserved.
729e4ab9
A
7*******************************************************************************
8*/
9
10#include "unicode/utypes.h"
11
12#if !UCONFIG_NO_FORMATTING
13
14#include "unicode/locdspnm.h"
2ca993e8 15#include "unicode/simpleformatter.h"
f3c0d7a5 16#include "unicode/ucasemap.h"
51004dcb 17#include "unicode/ures.h"
2ca993e8 18#include "unicode/udisplaycontext.h"
51004dcb 19#include "unicode/brkiter.h"
2ca993e8 20#include "unicode/ucurr.h"
729e4ab9
A
21#include "cmemory.h"
22#include "cstring.h"
b331163b 23#include "mutex.h"
729e4ab9 24#include "ulocimp.h"
b331163b 25#include "umutex.h"
729e4ab9 26#include "ureslocs.h"
51004dcb 27#include "uresimp.h"
729e4ab9
A
28
29#include <stdarg.h>
30
31/**
32 * Concatenate a number of null-terminated strings to buffer, leaving a
33 * null-terminated string. The last argument should be the null pointer.
34 * Return the length of the string in the buffer, not counting the trailing
35 * null. Return -1 if there is an error (buffer is null, or buflen < 1).
36 */
37static int32_t ncat(char *buffer, uint32_t buflen, ...) {
38 va_list args;
39 char *str;
40 char *p = buffer;
41 const char* e = buffer + buflen - 1;
42
43 if (buffer == NULL || buflen < 1) {
44 return -1;
45 }
46
47 va_start(args, buflen);
3d1f044b 48 while ((str = va_arg(args, char *)) != 0) {
729e4ab9 49 char c;
3d1f044b 50 while (p != e && (c = *str++) != 0) {
729e4ab9
A
51 *p++ = c;
52 }
53 }
54 *p = 0;
55 va_end(args);
56
0f5d89e8 57 return static_cast<int32_t>(p - buffer);
729e4ab9
A
58}
59
60U_NAMESPACE_BEGIN
61
62////////////////////////////////////////////////////////////////////////////////////////////////////
63
64// Access resource data for locale components.
65// Wrap code in uloc.c for now.
66class ICUDataTable {
51004dcb
A
67 const char* path;
68 Locale locale;
729e4ab9
A
69
70public:
51004dcb
A
71 ICUDataTable(const char* path, const Locale& locale);
72 ~ICUDataTable();
729e4ab9 73
51004dcb 74 const Locale& getLocale();
729e4ab9 75
51004dcb
A
76 UnicodeString& get(const char* tableKey, const char* itemKey,
77 UnicodeString& result) const;
78 UnicodeString& get(const char* tableKey, const char* subTableKey, const char* itemKey,
79 UnicodeString& result) const;
729e4ab9 80
51004dcb
A
81 UnicodeString& getNoFallback(const char* tableKey, const char* itemKey,
82 UnicodeString &result) const;
83 UnicodeString& getNoFallback(const char* tableKey, const char* subTableKey, const char* itemKey,
84 UnicodeString &result) const;
729e4ab9
A
85};
86
87inline UnicodeString &
88ICUDataTable::get(const char* tableKey, const char* itemKey, UnicodeString& result) const {
51004dcb 89 return get(tableKey, NULL, itemKey, result);
729e4ab9
A
90}
91
92inline UnicodeString &
93ICUDataTable::getNoFallback(const char* tableKey, const char* itemKey, UnicodeString& result) const {
51004dcb 94 return getNoFallback(tableKey, NULL, itemKey, result);
729e4ab9
A
95}
96
97ICUDataTable::ICUDataTable(const char* path, const Locale& locale)
51004dcb 98 : path(NULL), locale(Locale::getRoot())
729e4ab9
A
99{
100 if (path) {
3d1f044b 101 int32_t len = static_cast<int32_t>(uprv_strlen(path));
729e4ab9
A
102 this->path = (const char*) uprv_malloc(len + 1);
103 if (this->path) {
104 uprv_strcpy((char *)this->path, path);
105 this->locale = locale;
106 }
107 }
108}
109
110ICUDataTable::~ICUDataTable() {
111 if (path) {
112 uprv_free((void*) path);
113 path = NULL;
114 }
115}
116
117const Locale&
118ICUDataTable::getLocale() {
119 return locale;
120}
121
122UnicodeString &
123ICUDataTable::get(const char* tableKey, const char* subTableKey, const char* itemKey,
124 UnicodeString &result) const {
125 UErrorCode status = U_ZERO_ERROR;
126 int32_t len = 0;
127
128 const UChar *s = uloc_getTableStringWithFallback(path, locale.getName(),
129 tableKey, subTableKey, itemKey,
130 &len, &status);
4388f060 131 if (U_SUCCESS(status) && len > 0) {
729e4ab9
A
132 return result.setTo(s, len);
133 }
134 return result.setTo(UnicodeString(itemKey, -1, US_INV));
135}
136
137UnicodeString &
138ICUDataTable::getNoFallback(const char* tableKey, const char* subTableKey, const char* itemKey,
139 UnicodeString& result) const {
140 UErrorCode status = U_ZERO_ERROR;
141 int32_t len = 0;
142
143 const UChar *s = uloc_getTableStringWithFallback(path, locale.getName(),
144 tableKey, subTableKey, itemKey,
145 &len, &status);
146 if (U_SUCCESS(status)) {
147 return result.setTo(s, len);
148 }
149
150 result.setToBogus();
151 return result;
152}
153
154////////////////////////////////////////////////////////////////////////////////////////////////////
155
4388f060
A
156LocaleDisplayNames::~LocaleDisplayNames() {}
157
729e4ab9
A
158////////////////////////////////////////////////////////////////////////////////////////////////////
159
160#if 0 // currently unused
161
162class DefaultLocaleDisplayNames : public LocaleDisplayNames {
163 UDialectHandling dialectHandling;
164
165public:
166 // constructor
167 DefaultLocaleDisplayNames(UDialectHandling dialectHandling);
168
169 virtual ~DefaultLocaleDisplayNames();
170
171 virtual const Locale& getLocale() const;
172 virtual UDialectHandling getDialectHandling() const;
51004dcb 173
729e4ab9
A
174 virtual UnicodeString& localeDisplayName(const Locale& locale,
175 UnicodeString& result) const;
176 virtual UnicodeString& localeDisplayName(const char* localeId,
177 UnicodeString& result) const;
178 virtual UnicodeString& languageDisplayName(const char* lang,
179 UnicodeString& result) const;
180 virtual UnicodeString& scriptDisplayName(const char* script,
181 UnicodeString& result) const;
182 virtual UnicodeString& scriptDisplayName(UScriptCode scriptCode,
183 UnicodeString& result) const;
184 virtual UnicodeString& regionDisplayName(const char* region,
185 UnicodeString& result) const;
186 virtual UnicodeString& variantDisplayName(const char* variant,
187 UnicodeString& result) const;
188 virtual UnicodeString& keyDisplayName(const char* key,
189 UnicodeString& result) const;
190 virtual UnicodeString& keyValueDisplayName(const char* key,
191 const char* value,
192 UnicodeString& result) const;
193};
194
195DefaultLocaleDisplayNames::DefaultLocaleDisplayNames(UDialectHandling dialectHandling)
196 : dialectHandling(dialectHandling) {
197}
198
199DefaultLocaleDisplayNames::~DefaultLocaleDisplayNames() {
200}
201
202const Locale&
203DefaultLocaleDisplayNames::getLocale() const {
204 return Locale::getRoot();
205}
206
207UDialectHandling
208DefaultLocaleDisplayNames::getDialectHandling() const {
209 return dialectHandling;
210}
211
212UnicodeString&
213DefaultLocaleDisplayNames::localeDisplayName(const Locale& locale,
214 UnicodeString& result) const {
215 return result = UnicodeString(locale.getName(), -1, US_INV);
216}
217
218UnicodeString&
219DefaultLocaleDisplayNames::localeDisplayName(const char* localeId,
220 UnicodeString& result) const {
221 return result = UnicodeString(localeId, -1, US_INV);
222}
223
224UnicodeString&
225DefaultLocaleDisplayNames::languageDisplayName(const char* lang,
226 UnicodeString& result) const {
227 return result = UnicodeString(lang, -1, US_INV);
228}
229
230UnicodeString&
231DefaultLocaleDisplayNames::scriptDisplayName(const char* script,
232 UnicodeString& result) const {
233 return result = UnicodeString(script, -1, US_INV);
234}
235
236UnicodeString&
237DefaultLocaleDisplayNames::scriptDisplayName(UScriptCode scriptCode,
238 UnicodeString& result) const {
239 const char* name = uscript_getName(scriptCode);
240 if (name) {
241 return result = UnicodeString(name, -1, US_INV);
242 }
243 return result.remove();
244}
245
246UnicodeString&
247DefaultLocaleDisplayNames::regionDisplayName(const char* region,
248 UnicodeString& result) const {
249 return result = UnicodeString(region, -1, US_INV);
250}
251
252UnicodeString&
253DefaultLocaleDisplayNames::variantDisplayName(const char* variant,
254 UnicodeString& result) const {
255 return result = UnicodeString(variant, -1, US_INV);
256}
257
258UnicodeString&
259DefaultLocaleDisplayNames::keyDisplayName(const char* key,
260 UnicodeString& result) const {
261 return result = UnicodeString(key, -1, US_INV);
262}
263
264UnicodeString&
265DefaultLocaleDisplayNames::keyValueDisplayName(const char* /* key */,
266 const char* value,
267 UnicodeString& result) const {
268 return result = UnicodeString(value, -1, US_INV);
269}
270
271#endif // currently unused class DefaultLocaleDisplayNames
272
273////////////////////////////////////////////////////////////////////////////////////////////////////
274
275class LocaleDisplayNamesImpl : public LocaleDisplayNames {
51004dcb
A
276 Locale locale;
277 UDialectHandling dialectHandling;
278 ICUDataTable langData;
279 ICUDataTable regionData;
2ca993e8
A
280 SimpleFormatter separatorFormat;
281 SimpleFormatter format;
282 SimpleFormatter keyTypeFormat;
51004dcb 283 UDisplayContext capitalizationContext;
f3c0d7a5 284#if !UCONFIG_NO_BREAK_ITERATION
2ca993e8 285 BreakIterator* capitalizationBrkIter;
f3c0d7a5
A
286#else
287 UObject* capitalizationBrkIter;
288#endif
57a6839d
A
289 UnicodeString formatOpenParen;
290 UnicodeString formatReplaceOpenParen;
291 UnicodeString formatCloseParen;
292 UnicodeString formatReplaceCloseParen;
3d1f044b 293 UnicodeString formatParenCloseOpen;
57a6839d 294 UDisplayContext nameLength;
51004dcb
A
295
296 // Constants for capitalization context usage types.
297 enum CapContextUsage {
298 kCapContextUsageLanguage,
299 kCapContextUsageScript,
300 kCapContextUsageTerritory,
301 kCapContextUsageVariant,
302 kCapContextUsageKey,
57a6839d 303 kCapContextUsageKeyValue,
51004dcb
A
304 kCapContextUsageCount
305 };
57a6839d
A
306 // Capitalization transforms. For each usage type, indicates whether to titlecase for
307 // the context specified in capitalizationContext (which we know at construction time)
308 UBool fCapitalization[kCapContextUsageCount];
729e4ab9
A
309
310public:
51004dcb
A
311 // constructor
312 LocaleDisplayNamesImpl(const Locale& locale, UDialectHandling dialectHandling);
313 LocaleDisplayNamesImpl(const Locale& locale, UDisplayContext *contexts, int32_t length);
314 virtual ~LocaleDisplayNamesImpl();
315
316 virtual const Locale& getLocale() const;
317 virtual UDialectHandling getDialectHandling() const;
318 virtual UDisplayContext getContext(UDisplayContextType type) const;
319
320 virtual UnicodeString& localeDisplayName(const Locale& locale,
321 UnicodeString& result) const;
322 virtual UnicodeString& localeDisplayName(const char* localeId,
323 UnicodeString& result) const;
324 virtual UnicodeString& languageDisplayName(const char* lang,
325 UnicodeString& result) const;
326 virtual UnicodeString& scriptDisplayName(const char* script,
327 UnicodeString& result) const;
328 virtual UnicodeString& scriptDisplayName(UScriptCode scriptCode,
329 UnicodeString& result) const;
330 virtual UnicodeString& regionDisplayName(const char* region,
331 UnicodeString& result) const;
332 virtual UnicodeString& variantDisplayName(const char* variant,
333 UnicodeString& result) const;
334 virtual UnicodeString& keyDisplayName(const char* key,
335 UnicodeString& result) const;
336 virtual UnicodeString& keyValueDisplayName(const char* key,
337 const char* value,
338 UnicodeString& result) const;
729e4ab9 339private:
51004dcb
A
340 UnicodeString& localeIdName(const char* localeId,
341 UnicodeString& result) const;
2ca993e8
A
342 UnicodeString& regionShortDisplayName(const char* region, // Apple-specific
343 UnicodeString& result) const;
51004dcb
A
344 UnicodeString& appendWithSep(UnicodeString& buffer, const UnicodeString& src) const;
345 UnicodeString& adjustForUsageAndContext(CapContextUsage usage, UnicodeString& result) const;
2ca993e8
A
346 UnicodeString& scriptDisplayName(const char* script, UnicodeString& result, UBool skipAdjust) const;
347 UnicodeString& regionDisplayName(const char* region, UnicodeString& result, UBool skipAdjust) const;
348 UnicodeString& variantDisplayName(const char* variant, UnicodeString& result, UBool skipAdjust) const;
349 UnicodeString& keyDisplayName(const char* key, UnicodeString& result, UBool skipAdjust) const;
350 UnicodeString& keyValueDisplayName(const char* key, const char* value,
351 UnicodeString& result, UBool skipAdjust) const;
51004dcb 352 void initialize(void);
f3c0d7a5
A
353
354 struct CapitalizationContextSink;
729e4ab9
A
355};
356
357LocaleDisplayNamesImpl::LocaleDisplayNamesImpl(const Locale& locale,
358 UDialectHandling dialectHandling)
51004dcb
A
359 : dialectHandling(dialectHandling)
360 , langData(U_ICUDATA_LANG, locale)
361 , regionData(U_ICUDATA_REGION, locale)
51004dcb 362 , capitalizationContext(UDISPCTX_CAPITALIZATION_NONE)
57a6839d 363 , capitalizationBrkIter(NULL)
b331163b 364 , nameLength(UDISPCTX_LENGTH_FULL)
729e4ab9 365{
51004dcb
A
366 initialize();
367}
729e4ab9 368
51004dcb
A
369LocaleDisplayNamesImpl::LocaleDisplayNamesImpl(const Locale& locale,
370 UDisplayContext *contexts, int32_t length)
371 : dialectHandling(ULDN_STANDARD_NAMES)
372 , langData(U_ICUDATA_LANG, locale)
373 , regionData(U_ICUDATA_REGION, locale)
51004dcb 374 , capitalizationContext(UDISPCTX_CAPITALIZATION_NONE)
57a6839d 375 , capitalizationBrkIter(NULL)
b331163b 376 , nameLength(UDISPCTX_LENGTH_FULL)
51004dcb
A
377{
378 while (length-- > 0) {
379 UDisplayContext value = *contexts++;
380 UDisplayContextType selector = (UDisplayContextType)((uint32_t)value >> 8);
381 switch (selector) {
382 case UDISPCTX_TYPE_DIALECT_HANDLING:
383 dialectHandling = (UDialectHandling)value;
384 break;
385 case UDISPCTX_TYPE_CAPITALIZATION:
386 capitalizationContext = value;
387 break;
b331163b 388 case UDISPCTX_TYPE_DISPLAY_LENGTH:
57a6839d
A
389 nameLength = value;
390 break;
b331163b
A
391 case UADISPCTX_TYPE_LENGTH: // Apple-specific
392 nameLength = (value == UADISPCTX_LENGTH_SHORT)? UDISPCTX_LENGTH_SHORT: UDISPCTX_LENGTH_FULL;
393 break;
51004dcb
A
394 default:
395 break;
396 }
397 }
398 initialize();
399}
729e4ab9 400
f3c0d7a5
A
401struct LocaleDisplayNamesImpl::CapitalizationContextSink : public ResourceSink {
402 UBool hasCapitalizationUsage;
403 LocaleDisplayNamesImpl& parent;
404
405 CapitalizationContextSink(LocaleDisplayNamesImpl& _parent)
406 : hasCapitalizationUsage(FALSE), parent(_parent) {}
407 virtual ~CapitalizationContextSink();
408
409 virtual void put(const char *key, ResourceValue &value, UBool /*noFallback*/,
410 UErrorCode &errorCode) {
411 ResourceTable contexts = value.getTable(errorCode);
412 if (U_FAILURE(errorCode)) { return; }
413 for (int i = 0; contexts.getKeyAndValue(i, key, value); ++i) {
414
415 CapContextUsage usageEnum;
416 if (uprv_strcmp(key, "key") == 0) {
417 usageEnum = kCapContextUsageKey;
418 } else if (uprv_strcmp(key, "keyValue") == 0) {
419 usageEnum = kCapContextUsageKeyValue;
420 } else if (uprv_strcmp(key, "languages") == 0) {
421 usageEnum = kCapContextUsageLanguage;
422 } else if (uprv_strcmp(key, "script") == 0) {
423 usageEnum = kCapContextUsageScript;
424 } else if (uprv_strcmp(key, "territory") == 0) {
425 usageEnum = kCapContextUsageTerritory;
426 } else if (uprv_strcmp(key, "variant") == 0) {
427 usageEnum = kCapContextUsageVariant;
428 } else {
429 continue;
430 }
431
432 int32_t len = 0;
433 const int32_t* intVector = value.getIntVector(len, errorCode);
434 if (U_FAILURE(errorCode)) { return; }
435 if (len < 2) { continue; }
436
437 int32_t titlecaseInt = (parent.capitalizationContext == UDISPCTX_CAPITALIZATION_FOR_UI_LIST_OR_MENU) ? intVector[0] : intVector[1];
438 if (titlecaseInt == 0) { continue; }
439
440 parent.fCapitalization[usageEnum] = TRUE;
441 hasCapitalizationUsage = TRUE;
442 }
443 }
444};
445
446// Virtual destructors must be defined out of line.
447LocaleDisplayNamesImpl::CapitalizationContextSink::~CapitalizationContextSink() {}
448
51004dcb
A
449void
450LocaleDisplayNamesImpl::initialize(void) {
451 LocaleDisplayNamesImpl *nonConstThis = (LocaleDisplayNamesImpl *)this;
452 nonConstThis->locale = langData.getLocale() == Locale::getRoot()
453 ? regionData.getLocale()
454 : langData.getLocale();
4388f060 455
57a6839d 456 UnicodeString sep;
51004dcb
A
457 langData.getNoFallback("localeDisplayPattern", "separator", sep);
458 if (sep.isBogus()) {
57a6839d 459 sep = UnicodeString("{0}, {1}", -1, US_INV);
51004dcb 460 }
57a6839d 461 UErrorCode status = U_ZERO_ERROR;
2ca993e8 462 separatorFormat.applyPatternMinMaxArguments(sep, 2, 2, status);
51004dcb
A
463
464 UnicodeString pattern;
465 langData.getNoFallback("localeDisplayPattern", "pattern", pattern);
466 if (pattern.isBogus()) {
467 pattern = UnicodeString("{0} ({1})", -1, US_INV);
468 }
2ca993e8 469 format.applyPatternMinMaxArguments(pattern, 2, 2, status);
57a6839d
A
470 if (pattern.indexOf((UChar)0xFF08) >= 0) {
471 formatOpenParen.setTo((UChar)0xFF08); // fullwidth (
472 formatReplaceOpenParen.setTo((UChar)0xFF3B); // fullwidth [
473 formatCloseParen.setTo((UChar)0xFF09); // fullwidth )
474 formatReplaceCloseParen.setTo((UChar)0xFF3D); // fullwidth ]
3d1f044b
A
475 formatParenCloseOpen.setTo(u")(", 2); // fullwidth FF09 FF08 redundant parens
476
57a6839d
A
477 } else {
478 formatOpenParen.setTo((UChar)0x0028); // (
479 formatReplaceOpenParen.setTo((UChar)0x005B); // [
480 formatCloseParen.setTo((UChar)0x0029); // )
481 formatReplaceCloseParen.setTo((UChar)0x005D); // ]
3d1f044b 482 formatParenCloseOpen.setTo(u") (", 3); // halfwidth redundant parens
57a6839d 483 }
51004dcb
A
484
485 UnicodeString ktPattern;
486 langData.get("localeDisplayPattern", "keyTypePattern", ktPattern);
487 if (ktPattern.isBogus()) {
488 ktPattern = UnicodeString("{0}={1}", -1, US_INV);
489 }
2ca993e8 490 keyTypeFormat.applyPatternMinMaxArguments(ktPattern, 2, 2, status);
51004dcb
A
491
492 uprv_memset(fCapitalization, 0, sizeof(fCapitalization));
493#if !UCONFIG_NO_BREAK_ITERATION
57a6839d
A
494 // Only get the context data if we need it! This is a const object so we know now...
495 // Also check whether we will need a break iterator (depends on the data)
496 UBool needBrkIter = FALSE;
497 if (capitalizationContext == UDISPCTX_CAPITALIZATION_FOR_UI_LIST_OR_MENU || capitalizationContext == UDISPCTX_CAPITALIZATION_FOR_STANDALONE) {
f3c0d7a5
A
498 LocalUResourceBundlePointer resource(ures_open(NULL, locale.getName(), &status));
499 if (U_FAILURE(status)) { return; }
500 CapitalizationContextSink sink(*this);
501 ures_getAllItemsWithFallback(resource.getAlias(), "contextTransforms", sink, status);
502 if (status == U_MISSING_RESOURCE_ERROR) {
503 // Silently ignore. Not every locale has contextTransforms.
504 status = U_ZERO_ERROR;
505 } else if (U_FAILURE(status)) {
506 return;
57a6839d 507 }
f3c0d7a5 508 needBrkIter = sink.hasCapitalizationUsage;
57a6839d
A
509 }
510 // Get a sentence break iterator if we will need it
511 if (needBrkIter || capitalizationContext == UDISPCTX_CAPITALIZATION_FOR_BEGINNING_OF_SENTENCE) {
512 status = U_ZERO_ERROR;
513 capitalizationBrkIter = BreakIterator::createSentenceInstance(locale, status);
514 if (U_FAILURE(status)) {
515 delete capitalizationBrkIter;
516 capitalizationBrkIter = NULL;
51004dcb 517 }
51004dcb
A
518 }
519#endif
729e4ab9
A
520}
521
522LocaleDisplayNamesImpl::~LocaleDisplayNamesImpl() {
f3c0d7a5 523#if !UCONFIG_NO_BREAK_ITERATION
57a6839d 524 delete capitalizationBrkIter;
f3c0d7a5
A
525#endif
526}
729e4ab9
A
527
528const Locale&
529LocaleDisplayNamesImpl::getLocale() const {
51004dcb 530 return locale;
729e4ab9
A
531}
532
533UDialectHandling
534LocaleDisplayNamesImpl::getDialectHandling() const {
51004dcb
A
535 return dialectHandling;
536}
537
538UDisplayContext
539LocaleDisplayNamesImpl::getContext(UDisplayContextType type) const {
540 switch (type) {
541 case UDISPCTX_TYPE_DIALECT_HANDLING:
542 return (UDisplayContext)dialectHandling;
543 case UDISPCTX_TYPE_CAPITALIZATION:
544 return capitalizationContext;
b331163b 545 case UDISPCTX_TYPE_DISPLAY_LENGTH:
57a6839d 546 return nameLength;
b331163b
A
547 case UADISPCTX_TYPE_LENGTH: // Apple-specific
548 return (nameLength == UDISPCTX_LENGTH_SHORT)? UADISPCTX_LENGTH_SHORT: UADISPCTX_LENGTH_STANDARD;
51004dcb
A
549 default:
550 break;
551 }
552 return (UDisplayContext)0;
553}
554
555UnicodeString&
556LocaleDisplayNamesImpl::adjustForUsageAndContext(CapContextUsage usage,
557 UnicodeString& result) const {
558#if !UCONFIG_NO_BREAK_ITERATION
559 // check to see whether we need to titlecase result
57a6839d
A
560 if ( result.length() > 0 && u_islower(result.char32At(0)) && capitalizationBrkIter!= NULL &&
561 ( capitalizationContext==UDISPCTX_CAPITALIZATION_FOR_BEGINNING_OF_SENTENCE || fCapitalization[usage] ) ) {
562 // note fCapitalization[usage] won't be set unless capitalizationContext is UI_LIST_OR_MENU or STANDALONE
3d1f044b
A
563 static UMutex *capitalizationBrkIterLock = STATIC_NEW(UMutex);
564 Mutex lock(capitalizationBrkIterLock);
57a6839d 565 result.toTitle(capitalizationBrkIter, locale, U_TITLECASE_NO_LOWERCASE | U_TITLECASE_NO_BREAK_ADJUSTMENT);
51004dcb
A
566 }
567#endif
568 return result;
729e4ab9
A
569}
570
571UnicodeString&
3d1f044b 572LocaleDisplayNamesImpl::localeDisplayName(const Locale& loc,
729e4ab9 573 UnicodeString& result) const {
3d1f044b 574 if (loc.isBogus()) {
2ca993e8
A
575 result.setToBogus();
576 return result;
577 }
729e4ab9
A
578 UnicodeString resultName;
579
3d1f044b 580 const char* lang = loc.getLanguage();
729e4ab9
A
581 if (uprv_strlen(lang) == 0) {
582 lang = "root";
583 }
3d1f044b
A
584 const char* script = loc.getScript();
585 const char* country = loc.getCountry();
586 const char* variant = loc.getVariant();
729e4ab9
A
587
588 UBool hasScript = uprv_strlen(script) > 0;
589 UBool hasCountry = uprv_strlen(country) > 0;
590 UBool hasVariant = uprv_strlen(variant) > 0;
591
3d1f044b
A
592 // For stylistic reasons, always load dialect names for `zh` and `yue`. <rdar://50750364>
593 // Also for `ks`, 'pa, 'ur'. <rdar://50687287>
594 UBool forceDialect = (uprv_strcmp(lang, "zh") == 0 || uprv_strcmp(lang, "yue") == 0 ||
595 uprv_strcmp(lang, "ks") == 0 || uprv_strcmp(lang, "pa") == 0 || uprv_strcmp(lang, "ur") == 0);
596
597 if (forceDialect || dialectHandling == ULDN_DIALECT_NAMES) {
729e4ab9
A
598 char buffer[ULOC_FULLNAME_CAPACITY];
599 do { // loop construct is so we can break early out of search
600 if (hasScript && hasCountry) {
601 ncat(buffer, ULOC_FULLNAME_CAPACITY, lang, "_", script, "_", country, (char *)0);
602 localeIdName(buffer, resultName);
603 if (!resultName.isBogus()) {
604 hasScript = FALSE;
605 hasCountry = FALSE;
606 break;
607 }
608 }
609 if (hasScript) {
610 ncat(buffer, ULOC_FULLNAME_CAPACITY, lang, "_", script, (char *)0);
611 localeIdName(buffer, resultName);
612 if (!resultName.isBogus()) {
613 hasScript = FALSE;
614 break;
615 }
616 }
617 if (hasCountry) {
618 ncat(buffer, ULOC_FULLNAME_CAPACITY, lang, "_", country, (char*)0);
619 localeIdName(buffer, resultName);
620 if (!resultName.isBogus()) {
621 hasCountry = FALSE;
622 break;
623 }
624 }
625 } while (FALSE);
626 }
627 if (resultName.isBogus() || resultName.isEmpty()) {
628 localeIdName(lang, resultName);
629 }
630
631 UnicodeString resultRemainder;
632 UnicodeString temp;
729e4ab9
A
633 UErrorCode status = U_ZERO_ERROR;
634
635 if (hasScript) {
2ca993e8 636 resultRemainder.append(scriptDisplayName(script, temp, TRUE));
729e4ab9
A
637 }
638 if (hasCountry) {
b331163b 639 appendWithSep(resultRemainder, regionShortDisplayName(country, temp)); // Apple modification
729e4ab9
A
640 }
641 if (hasVariant) {
2ca993e8 642 appendWithSep(resultRemainder, variantDisplayName(variant, temp, TRUE));
729e4ab9 643 }
57a6839d
A
644 resultRemainder.findAndReplace(formatOpenParen, formatReplaceOpenParen);
645 resultRemainder.findAndReplace(formatCloseParen, formatReplaceCloseParen);
729e4ab9 646
3d1f044b 647 LocalPointer<StringEnumeration> e(loc.createKeywords(status));
2ca993e8 648 if (e.isValid() && U_SUCCESS(status)) {
729e4ab9
A
649 UnicodeString temp2;
650 char value[ULOC_KEYWORD_AND_VALUES_CAPACITY]; // sigh, no ULOC_VALUE_CAPACITY
651 const char* key;
652 while ((key = e->next((int32_t *)0, status)) != NULL) {
0f5d89e8 653 value[0] = 0;
3d1f044b 654 loc.getKeywordValue(key, value, ULOC_KEYWORD_AND_VALUES_CAPACITY, status);
0f5d89e8 655 if (U_FAILURE(status) || status == U_STRING_NOT_TERMINATED_WARNING) {
2ca993e8
A
656 return result;
657 }
658 keyDisplayName(key, temp, TRUE);
57a6839d
A
659 temp.findAndReplace(formatOpenParen, formatReplaceOpenParen);
660 temp.findAndReplace(formatCloseParen, formatReplaceCloseParen);
2ca993e8 661 keyValueDisplayName(key, value, temp2, TRUE);
57a6839d
A
662 temp2.findAndReplace(formatOpenParen, formatReplaceOpenParen);
663 temp2.findAndReplace(formatCloseParen, formatReplaceCloseParen);
4388f060
A
664 if (temp2 != UnicodeString(value, -1, US_INV)) {
665 appendWithSep(resultRemainder, temp2);
666 } else if (temp != UnicodeString(key, -1, US_INV)) {
667 UnicodeString temp3;
2ca993e8 668 keyTypeFormat.format(temp, temp2, temp3, status);
4388f060
A
669 appendWithSep(resultRemainder, temp3);
670 } else {
671 appendWithSep(resultRemainder, temp)
672 .append((UChar)0x3d /* = */)
673 .append(temp2);
674 }
729e4ab9 675 }
729e4ab9
A
676 }
677
678 if (!resultRemainder.isEmpty()) {
2ca993e8 679 format.format(resultName, resultRemainder, result.remove(), status);
3d1f044b
A
680 int32_t indexCloseOpen = result.indexOf(formatParenCloseOpen);
681 if (indexCloseOpen >= 0) { // replace redundant close-open parens with separator <rdar://problem/50687287>
682 UnicodeString tail(result, indexCloseOpen + formatParenCloseOpen.length()); // section after close-open
683 result.retainBetween(0, indexCloseOpen); // section before close-open
684 appendWithSep(result, tail); // combine using separator
685 }
51004dcb 686 return adjustForUsageAndContext(kCapContextUsageLanguage, result);
729e4ab9
A
687 }
688
51004dcb
A
689 result = resultName;
690 return adjustForUsageAndContext(kCapContextUsageLanguage, result);
729e4ab9
A
691}
692
693UnicodeString&
694LocaleDisplayNamesImpl::appendWithSep(UnicodeString& buffer, const UnicodeString& src) const {
57a6839d
A
695 if (buffer.isEmpty()) {
696 buffer.setTo(src);
697 } else {
2ca993e8 698 const UnicodeString *values[2] = { &buffer, &src };
57a6839d 699 UErrorCode status = U_ZERO_ERROR;
2ca993e8 700 separatorFormat.formatAndReplace(values, 2, buffer, NULL, 0, status);
51004dcb 701 }
51004dcb 702 return buffer;
729e4ab9
A
703}
704
705UnicodeString&
706LocaleDisplayNamesImpl::localeDisplayName(const char* localeId,
707 UnicodeString& result) const {
51004dcb 708 return localeDisplayName(Locale(localeId), result);
729e4ab9
A
709}
710
51004dcb 711// private
729e4ab9
A
712UnicodeString&
713LocaleDisplayNamesImpl::localeIdName(const char* localeId,
714 UnicodeString& result) const {
b331163b
A
715 if (nameLength == UDISPCTX_LENGTH_SHORT) {
716 langData.getNoFallback("Languages%short", localeId, result);
57a6839d
A
717 if (!result.isBogus()) {
718 return result;
719 }
720 }
51004dcb 721 return langData.getNoFallback("Languages", localeId, result);
729e4ab9
A
722}
723
724UnicodeString&
725LocaleDisplayNamesImpl::languageDisplayName(const char* lang,
726 UnicodeString& result) const {
51004dcb
A
727 if (uprv_strcmp("root", lang) == 0 || uprv_strchr(lang, '_') != NULL) {
728 return result = UnicodeString(lang, -1, US_INV);
729 }
b331163b 730 if (nameLength == UDISPCTX_LENGTH_SHORT) {
2ca993e8 731 langData.getNoFallback("Languages%short", lang, result);
57a6839d
A
732 if (!result.isBogus()) {
733 return adjustForUsageAndContext(kCapContextUsageLanguage, result);
734 }
735 }
51004dcb
A
736 langData.get("Languages", lang, result);
737 return adjustForUsageAndContext(kCapContextUsageLanguage, result);
729e4ab9
A
738}
739
740UnicodeString&
741LocaleDisplayNamesImpl::scriptDisplayName(const char* script,
2ca993e8
A
742 UnicodeString& result,
743 UBool skipAdjust) const {
744 if (!skipAdjust) { // => prefer standalone
745 langData.getNoFallback("Scripts%stand-alone", script, result);
b331163b
A
746 if (!result.isBogus()) {
747 return adjustForUsageAndContext(kCapContextUsageScript, result);
748 }
749 }
2ca993e8
A
750 if (nameLength == UDISPCTX_LENGTH_SHORT) {
751 langData.getNoFallback("Scripts%short", script, result);
752 if (!result.isBogus()) {
753 return skipAdjust? result: adjustForUsageAndContext(kCapContextUsageScript, result);
754 }
755 }
51004dcb 756 langData.get("Scripts", script, result);
2ca993e8
A
757 return skipAdjust? result: adjustForUsageAndContext(kCapContextUsageScript, result);
758}
759
760UnicodeString&
761LocaleDisplayNamesImpl::scriptDisplayName(const char* script,
762 UnicodeString& result) const {
763 return scriptDisplayName(script, result, FALSE);
729e4ab9
A
764}
765
766UnicodeString&
767LocaleDisplayNamesImpl::scriptDisplayName(UScriptCode scriptCode,
768 UnicodeString& result) const {
2ca993e8 769 return scriptDisplayName(uscript_getName(scriptCode), result, FALSE);
729e4ab9
A
770}
771
772UnicodeString&
773LocaleDisplayNamesImpl::regionDisplayName(const char* region,
2ca993e8
A
774 UnicodeString& result,
775 UBool skipAdjust) const {
b331163b 776 if (nameLength == UDISPCTX_LENGTH_SHORT) {
2ca993e8 777 regionData.getNoFallback("Countries%short", region, result);
57a6839d 778 if (!result.isBogus()) {
2ca993e8 779 return skipAdjust? result: adjustForUsageAndContext(kCapContextUsageTerritory, result);
57a6839d
A
780 }
781 }
782 regionData.get("Countries", region, result);
2ca993e8 783 return skipAdjust? result: adjustForUsageAndContext(kCapContextUsageTerritory, result);
57a6839d
A
784}
785
2ca993e8
A
786// private Apple, only for building localeDisplayName
787// (use short region, don't adjust for context)
57a6839d
A
788UnicodeString&
789LocaleDisplayNamesImpl::regionShortDisplayName(const char* region,
790 UnicodeString& result) const {
791 if (uprv_strcmp(region, "PS") != 0) {
b331163b 792 regionData.getNoFallback("Countries%short", region, result);
57a6839d 793 if (!result.isBogus()) {
2ca993e8 794 return result;
57a6839d
A
795 }
796 }
51004dcb 797 regionData.get("Countries", region, result);
2ca993e8 798 return result;
729e4ab9
A
799}
800
2ca993e8
A
801UnicodeString&
802LocaleDisplayNamesImpl::regionDisplayName(const char* region,
803 UnicodeString& result) const {
804 return regionDisplayName(region, result, FALSE);
805}
806
807
729e4ab9
A
808UnicodeString&
809LocaleDisplayNamesImpl::variantDisplayName(const char* variant,
2ca993e8
A
810 UnicodeString& result,
811 UBool skipAdjust) const {
b331163b 812 // don't have a resource for short variant names
51004dcb 813 langData.get("Variants", variant, result);
2ca993e8
A
814 return skipAdjust? result: adjustForUsageAndContext(kCapContextUsageVariant, result);
815}
816
817UnicodeString&
818LocaleDisplayNamesImpl::variantDisplayName(const char* variant,
819 UnicodeString& result) const {
820 return variantDisplayName(variant, result, FALSE);
729e4ab9
A
821}
822
823UnicodeString&
824LocaleDisplayNamesImpl::keyDisplayName(const char* key,
2ca993e8
A
825 UnicodeString& result,
826 UBool skipAdjust) const {
b331163b 827 // don't have a resource for short key names
51004dcb 828 langData.get("Keys", key, result);
2ca993e8
A
829 return skipAdjust? result: adjustForUsageAndContext(kCapContextUsageKey, result);
830}
831
832UnicodeString&
833LocaleDisplayNamesImpl::keyDisplayName(const char* key,
834 UnicodeString& result) const {
835 return keyDisplayName(key, result, FALSE);
729e4ab9
A
836}
837
838UnicodeString&
839LocaleDisplayNamesImpl::keyValueDisplayName(const char* key,
840 const char* value,
2ca993e8
A
841 UnicodeString& result,
842 UBool skipAdjust) const {
b331163b
A
843 if (uprv_strcmp(key, "currency") == 0) {
844 // ICU4C does not have ICU4J CurrencyDisplayInfo equivalent for now.
845 UErrorCode sts = U_ZERO_ERROR;
846 UnicodeString ustrValue(value, -1, US_INV);
847 int32_t len;
848 UBool isChoice = FALSE;
849 const UChar *currencyName = ucurr_getName(ustrValue.getTerminatedBuffer(),
850 locale.getBaseName(), UCURR_LONG_NAME, &isChoice, &len, &sts);
851 if (U_FAILURE(sts)) {
852 // Return the value as is on failure
853 result = ustrValue;
854 return result;
855 }
856 result.setTo(currencyName, len);
2ca993e8 857 return skipAdjust? result: adjustForUsageAndContext(kCapContextUsageKeyValue, result);
b331163b
A
858 }
859
860 if (nameLength == UDISPCTX_LENGTH_SHORT) {
861 langData.get("Types%short", key, value, result);
862 if (!result.isBogus()) {
2ca993e8 863 return skipAdjust? result: adjustForUsageAndContext(kCapContextUsageKeyValue, result);
b331163b
A
864 }
865 }
51004dcb 866 langData.get("Types", key, value, result);
2ca993e8
A
867 return skipAdjust? result: adjustForUsageAndContext(kCapContextUsageKeyValue, result);
868}
869
870UnicodeString&
871LocaleDisplayNamesImpl::keyValueDisplayName(const char* key,
872 const char* value,
873 UnicodeString& result) const {
874 return keyValueDisplayName(key, value, result, FALSE);
729e4ab9
A
875}
876
877////////////////////////////////////////////////////////////////////////////////////////////////////
878
879LocaleDisplayNames*
880LocaleDisplayNames::createInstance(const Locale& locale,
881 UDialectHandling dialectHandling) {
51004dcb
A
882 return new LocaleDisplayNamesImpl(locale, dialectHandling);
883}
884
885LocaleDisplayNames*
886LocaleDisplayNames::createInstance(const Locale& locale,
887 UDisplayContext *contexts, int32_t length) {
888 if (contexts == NULL) {
889 length = 0;
890 }
891 return new LocaleDisplayNamesImpl(locale, contexts, length);
729e4ab9
A
892}
893
894U_NAMESPACE_END
895
896////////////////////////////////////////////////////////////////////////////////////////////////////
897
898U_NAMESPACE_USE
899
51004dcb 900U_CAPI ULocaleDisplayNames * U_EXPORT2
729e4ab9
A
901uldn_open(const char * locale,
902 UDialectHandling dialectHandling,
903 UErrorCode *pErrorCode) {
904 if (U_FAILURE(*pErrorCode)) {
905 return 0;
906 }
907 if (locale == NULL) {
908 locale = uloc_getDefault();
909 }
910 return (ULocaleDisplayNames *)LocaleDisplayNames::createInstance(Locale(locale), dialectHandling);
911}
912
51004dcb
A
913U_CAPI ULocaleDisplayNames * U_EXPORT2
914uldn_openForContext(const char * locale,
915 UDisplayContext *contexts, int32_t length,
916 UErrorCode *pErrorCode) {
917 if (U_FAILURE(*pErrorCode)) {
918 return 0;
919 }
920 if (locale == NULL) {
921 locale = uloc_getDefault();
922 }
923 return (ULocaleDisplayNames *)LocaleDisplayNames::createInstance(Locale(locale), contexts, length);
924}
925
926
927U_CAPI void U_EXPORT2
729e4ab9
A
928uldn_close(ULocaleDisplayNames *ldn) {
929 delete (LocaleDisplayNames *)ldn;
930}
931
51004dcb 932U_CAPI const char * U_EXPORT2
729e4ab9
A
933uldn_getLocale(const ULocaleDisplayNames *ldn) {
934 if (ldn) {
935 return ((const LocaleDisplayNames *)ldn)->getLocale().getName();
936 }
937 return NULL;
938}
939
51004dcb 940U_CAPI UDialectHandling U_EXPORT2
729e4ab9
A
941uldn_getDialectHandling(const ULocaleDisplayNames *ldn) {
942 if (ldn) {
943 return ((const LocaleDisplayNames *)ldn)->getDialectHandling();
944 }
945 return ULDN_STANDARD_NAMES;
946}
947
51004dcb
A
948U_CAPI UDisplayContext U_EXPORT2
949uldn_getContext(const ULocaleDisplayNames *ldn,
950 UDisplayContextType type,
951 UErrorCode *pErrorCode) {
952 if (U_FAILURE(*pErrorCode)) {
953 return (UDisplayContext)0;
954 }
955 return ((const LocaleDisplayNames *)ldn)->getContext(type);
956}
957
958U_CAPI int32_t U_EXPORT2
729e4ab9
A
959uldn_localeDisplayName(const ULocaleDisplayNames *ldn,
960 const char *locale,
961 UChar *result,
962 int32_t maxResultSize,
963 UErrorCode *pErrorCode) {
964 if (U_FAILURE(*pErrorCode)) {
965 return 0;
966 }
967 if (ldn == NULL || locale == NULL || (result == NULL && maxResultSize > 0) || maxResultSize < 0) {
968 *pErrorCode = U_ILLEGAL_ARGUMENT_ERROR;
969 return 0;
970 }
971 UnicodeString temp(result, 0, maxResultSize);
972 ((const LocaleDisplayNames *)ldn)->localeDisplayName(locale, temp);
2ca993e8
A
973 if (temp.isBogus()) {
974 *pErrorCode = U_ILLEGAL_ARGUMENT_ERROR;
975 return 0;
976 }
729e4ab9
A
977 return temp.extract(result, maxResultSize, *pErrorCode);
978}
979
51004dcb 980U_CAPI int32_t U_EXPORT2
729e4ab9
A
981uldn_languageDisplayName(const ULocaleDisplayNames *ldn,
982 const char *lang,
983 UChar *result,
984 int32_t maxResultSize,
985 UErrorCode *pErrorCode) {
986 if (U_FAILURE(*pErrorCode)) {
987 return 0;
988 }
989 if (ldn == NULL || lang == NULL || (result == NULL && maxResultSize > 0) || maxResultSize < 0) {
990 *pErrorCode = U_ILLEGAL_ARGUMENT_ERROR;
991 return 0;
992 }
993 UnicodeString temp(result, 0, maxResultSize);
994 ((const LocaleDisplayNames *)ldn)->languageDisplayName(lang, temp);
995 return temp.extract(result, maxResultSize, *pErrorCode);
996}
997
51004dcb 998U_CAPI int32_t U_EXPORT2
729e4ab9
A
999uldn_scriptDisplayName(const ULocaleDisplayNames *ldn,
1000 const char *script,
1001 UChar *result,
1002 int32_t maxResultSize,
1003 UErrorCode *pErrorCode) {
1004 if (U_FAILURE(*pErrorCode)) {
1005 return 0;
1006 }
1007 if (ldn == NULL || script == NULL || (result == NULL && maxResultSize > 0) || maxResultSize < 0) {
1008 *pErrorCode = U_ILLEGAL_ARGUMENT_ERROR;
1009 return 0;
1010 }
1011 UnicodeString temp(result, 0, maxResultSize);
1012 ((const LocaleDisplayNames *)ldn)->scriptDisplayName(script, temp);
1013 return temp.extract(result, maxResultSize, *pErrorCode);
1014}
1015
51004dcb 1016U_CAPI int32_t U_EXPORT2
729e4ab9
A
1017uldn_scriptCodeDisplayName(const ULocaleDisplayNames *ldn,
1018 UScriptCode scriptCode,
1019 UChar *result,
1020 int32_t maxResultSize,
1021 UErrorCode *pErrorCode) {
1022 return uldn_scriptDisplayName(ldn, uscript_getName(scriptCode), result, maxResultSize, pErrorCode);
1023}
1024
51004dcb 1025U_CAPI int32_t U_EXPORT2
729e4ab9
A
1026uldn_regionDisplayName(const ULocaleDisplayNames *ldn,
1027 const char *region,
1028 UChar *result,
1029 int32_t maxResultSize,
1030 UErrorCode *pErrorCode) {
1031 if (U_FAILURE(*pErrorCode)) {
1032 return 0;
1033 }
1034 if (ldn == NULL || region == NULL || (result == NULL && maxResultSize > 0) || maxResultSize < 0) {
1035 *pErrorCode = U_ILLEGAL_ARGUMENT_ERROR;
1036 return 0;
1037 }
1038 UnicodeString temp(result, 0, maxResultSize);
1039 ((const LocaleDisplayNames *)ldn)->regionDisplayName(region, temp);
1040 return temp.extract(result, maxResultSize, *pErrorCode);
1041}
1042
51004dcb 1043U_CAPI int32_t U_EXPORT2
729e4ab9
A
1044uldn_variantDisplayName(const ULocaleDisplayNames *ldn,
1045 const char *variant,
1046 UChar *result,
1047 int32_t maxResultSize,
1048 UErrorCode *pErrorCode) {
1049 if (U_FAILURE(*pErrorCode)) {
1050 return 0;
1051 }
1052 if (ldn == NULL || variant == NULL || (result == NULL && maxResultSize > 0) || maxResultSize < 0) {
1053 *pErrorCode = U_ILLEGAL_ARGUMENT_ERROR;
1054 return 0;
1055 }
1056 UnicodeString temp(result, 0, maxResultSize);
1057 ((const LocaleDisplayNames *)ldn)->variantDisplayName(variant, temp);
1058 return temp.extract(result, maxResultSize, *pErrorCode);
1059}
1060
51004dcb 1061U_CAPI int32_t U_EXPORT2
729e4ab9
A
1062uldn_keyDisplayName(const ULocaleDisplayNames *ldn,
1063 const char *key,
1064 UChar *result,
1065 int32_t maxResultSize,
1066 UErrorCode *pErrorCode) {
1067 if (U_FAILURE(*pErrorCode)) {
1068 return 0;
1069 }
1070 if (ldn == NULL || key == NULL || (result == NULL && maxResultSize > 0) || maxResultSize < 0) {
1071 *pErrorCode = U_ILLEGAL_ARGUMENT_ERROR;
1072 return 0;
1073 }
1074 UnicodeString temp(result, 0, maxResultSize);
1075 ((const LocaleDisplayNames *)ldn)->keyDisplayName(key, temp);
1076 return temp.extract(result, maxResultSize, *pErrorCode);
1077}
1078
51004dcb 1079U_CAPI int32_t U_EXPORT2
729e4ab9
A
1080uldn_keyValueDisplayName(const ULocaleDisplayNames *ldn,
1081 const char *key,
1082 const char *value,
1083 UChar *result,
1084 int32_t maxResultSize,
1085 UErrorCode *pErrorCode) {
1086 if (U_FAILURE(*pErrorCode)) {
1087 return 0;
1088 }
1089 if (ldn == NULL || key == NULL || value == NULL || (result == NULL && maxResultSize > 0)
1090 || maxResultSize < 0) {
1091 *pErrorCode = U_ILLEGAL_ARGUMENT_ERROR;
1092 return 0;
1093 }
1094 UnicodeString temp(result, 0, maxResultSize);
1095 ((const LocaleDisplayNames *)ldn)->keyValueDisplayName(key, value, temp);
1096 return temp.extract(result, maxResultSize, *pErrorCode);
1097}
1098
1099#endif