Movatterモバイル変換

localematcher.h

1 // © 2019 and later: Unicode, Inc. and others.

2 // License & terms of use: http://www.unicode.org/copyright.html

3 

4 // localematcher.h

5 // created: 2019may08 Markus W. Scherer

6 

7 #ifndef __LOCALEMATCHER_H__

8 #define __LOCALEMATCHER_H__

9 

10 #include "unicode/utypes.h"

11 

12 #if U_SHOW_CPLUSPLUS_API

13 

14 #include <optional>

15 

16 #include "unicode/locid.h"

17 #include "unicode/stringpiece.h"

18 #include "unicode/uobject.h"

19 

31 enumULocMatchFavorSubtag {

38 ULOCMATCH_FAVOR_LANGUAGE,

44 ULOCMATCH_FAVOR_SCRIPT

45 };

46 #ifndef U_IN_DOXYGEN

47 typedefenumULocMatchFavorSubtagULocMatchFavorSubtag;

48 #endif

49 

57 enumULocMatchDemotion {

63 ULOCMATCH_DEMOTION_NONE,

90 ULOCMATCH_DEMOTION_REGION

91 };

92 #ifndef U_IN_DOXYGEN

93 typedefenumULocMatchDemotionULocMatchDemotion;

94 #endif

95 

113 enumULocMatchDirection {

119 ULOCMATCH_DIRECTION_WITH_ONE_WAY,

126 ULOCMATCH_DIRECTION_ONLY_TWO_WAY

127 };

128 #ifndef U_IN_DOXYGEN

129 typedefenumULocMatchDirectionULocMatchDirection;

130 #endif

131 

132 structUHashtable;

133 

134 U_NAMESPACE_BEGIN

135 

136 structLSR;

137 

138 classLikelySubtags;

139 classLocaleDistance;

140 classLocaleLsrIterator;

141 classUVector;

142 

186 classU_COMMON_APILocaleMatcher :publicUMemory {

187 public:

194 classU_COMMON_APIResult :publicUMemory {

195 public:

203 Result(Result &&src) noexcept;

204 

210 ~Result();

211 

219 Result &operator=(Result &&src) noexcept;

220 

228 inlineconstLocale *getDesiredLocale() const{return desiredLocale; }

229 

239 inlineconstLocale *getSupportedLocale() const{return supportedLocale; }

240 

248 inline int32_tgetDesiredIndex() const{return desiredIndex; }

249 

260 inline int32_tgetSupportedIndex() const{return supportedIndex; }

261 

274 LocalemakeResolvedLocale(UErrorCode &errorCode)const;

275 

276 private:

277 Result(constLocale *desired,constLocale *supported,

278  int32_t desIndex, int32_t suppIndex,UBool owned) :

279  desiredLocale(desired), supportedLocale(supported),

280  desiredIndex(desIndex), supportedIndex(suppIndex),

281  desiredIsOwned(owned) {}

282 

283 Result(constResult &other) =delete;

284 Result &operator=(constResult &other) =delete;

285 

286 constLocale *desiredLocale;

287 constLocale *supportedLocale;

288  int32_t desiredIndex;

289  int32_t supportedIndex;

290 UBool desiredIsOwned;

291 

292 friendclassLocaleMatcher;

293  };

294 

301 classU_COMMON_APIBuilder :publicUMemory {

302 public:

309 Builder() {}

310 

318 Builder(Builder &&src) noexcept;

319 

325 ~Builder();

326 

334 Builder &operator=(Builder &&src) noexcept;

335 

347 Builder &setSupportedLocalesFromListString(StringPiece locales);

348 

358 Builder &setSupportedLocales(Locale::Iterator &locales);

359 

373 template<typename Iter>

374 Builder &setSupportedLocales(Iter begin, Iter end) {

375 if (U_FAILURE(errorCode_)) {return *this; }

376  clearSupportedLocales();

377 while (begin != end) {

378  addSupportedLocale(*begin++);

379  }

380 return *this;

381  }

382 

398 template<typename Iter,typename Conv>

399 Builder &setSupportedLocalesViaConverter(Iter begin, Iter end, Conv converter) {

400 if (U_FAILURE(errorCode_)) {return *this; }

401  clearSupportedLocales();

402 while (begin != end) {

403  addSupportedLocale(converter(*begin++));

404  }

405 return *this;

406  }

407 

416 Builder &addSupportedLocale(constLocale &locale);

417 

426 Builder &setNoDefaultLocale();

427 

438 Builder &setDefaultLocale(constLocale *defaultLocale);

439 

450 Builder &setFavorSubtag(ULocMatchFavorSubtag subtag);

451 

460 Builder &setDemotionPerDesiredLocale(ULocMatchDemotion demotion);

461 

470 Builder &setDirection(ULocMatchDirection matchDirection) {

471 if (U_SUCCESS(errorCode_)) {

472  direction_ = matchDirection;

473  }

474 return *this;

475  }

476 

498 Builder &setMaxDistance(constLocale &desired,constLocale &supported);

499 

510 UBoolcopyErrorTo(UErrorCode &outErrorCode)const;

511 

522 LocaleMatcherbuild(UErrorCode &errorCode)const;

523 

524 private:

525 friendclassLocaleMatcher;

526 

527 Builder(constBuilder &other) =delete;

528 Builder &operator=(constBuilder &other) =delete;

529 

530 void clearSupportedLocales();

531 bool ensureSupportedLocaleVector();

532 

533 UErrorCode errorCode_ =U_ZERO_ERROR;

534  UVector *supportedLocales_ =nullptr;

535  int32_t thresholdDistance_ = -1;

536 ULocMatchDemotion demotion_ =ULOCMATCH_DEMOTION_REGION;

537 Locale *defaultLocale_ =nullptr;

538 bool withDefault_ =true;

539 ULocMatchFavorSubtag favor_ =ULOCMATCH_FAVOR_LANGUAGE;

540 ULocMatchDirection direction_ =ULOCMATCH_DIRECTION_WITH_ONE_WAY;

541 Locale *maxDistanceDesired_ =nullptr;

542 Locale *maxDistanceSupported_ =nullptr;

543  };

544 

545 // FYI No public LocaleMatcher constructors in C++; use the Builder.

546 

553 LocaleMatcher(LocaleMatcher &&src) noexcept;

554 

559 ~LocaleMatcher();

560 

569 LocaleMatcher &operator=(LocaleMatcher &&src) noexcept;

570 

581 constLocale *getBestMatch(constLocale &desiredLocale,UErrorCode &errorCode)const;

582 

593 constLocale *getBestMatch(Locale::Iterator &desiredLocales,UErrorCode &errorCode)const;

594 

609 constLocale *getBestMatchForListString(StringPiece desiredLocaleList,UErrorCode &errorCode)const;

610 

623 ResultgetBestMatchResult(constLocale &desiredLocale,UErrorCode &errorCode)const;

624 

637 ResultgetBestMatchResult(Locale::Iterator &desiredLocales,UErrorCode &errorCode)const;

638 

652 UBoolisMatch(constLocale &desired,constLocale &supported,UErrorCode &errorCode)const;

653 

654 #ifndef U_HIDE_INTERNAL_API

673 doubleinternalMatch(constLocale &desired,constLocale &supported,UErrorCode &errorCode)const;

674 #endif// U_HIDE_INTERNAL_API

675 

676 private:

677 LocaleMatcher(constBuilder &builder,UErrorCode &errorCode);

678 LocaleMatcher(constLocaleMatcher &other) =delete;

679 LocaleMatcher &operator=(constLocaleMatcher &other) =delete;

680 

681  int32_t putIfAbsent(const LSR &lsr, int32_t i, int32_t suppLength,UErrorCode &errorCode);

682 

683  std::optional<int32_t> getBestSuppIndex(LSR desiredLSR, LocaleLsrIterator *remainingIter,UErrorCode &errorCode)const;

684 

685 const LikelySubtags &likelySubtags;

686 const LocaleDistance &localeDistance;

687  int32_t thresholdDistance;

688  int32_t demotionPerDesiredLocale;

689 ULocMatchFavorSubtag favorSubtag;

690 ULocMatchDirection direction;

691 

692 // These are in input order.

693 constLocale ** supportedLocales;

694  LSR *lsrs;

695  int32_t supportedLocalesLength;

696 // These are in preference order: 1. Default locale 2. paradigm locales 3. others.

697 UHashtable *supportedLsrToIndex;// Map<LSR, Integer>

698 // Array versions of the supportedLsrToIndex keys and values.

699 // The distance lookup loops over the supportedLSRs and returns the index of the best match.

700 const LSR **supportedLSRs;

701  int32_t *supportedIndexes;

702  int32_t supportedLSRsLength;

703 Locale *ownedDefaultLocale;

704 constLocale *defaultLocale;

705 };

706 

707 U_NAMESPACE_END

708 

709 #endif// U_SHOW_CPLUSPLUS_API

710 #endif// __LOCALEMATCHER_H__