ICU 74.1 74.1

numberrangeformatter.h
Go to the documentation of this file.
1 // © 2018 and later: Unicode, Inc. and others.
2 // License & terms of use: http://www.unicode.org/copyright.html
3
4 #ifndef __NUMBERRANGEFORMATTER_H__
5 #define __NUMBERRANGEFORMATTER_H__
6
7 #include "unicode/utypes.h"
8
9 #if U_SHOW_CPLUSPLUS_API
10
11 #if !UCONFIG_NO_FORMATTING
12
13 #include <atomic>
14 #include "unicode/appendable.h"
15 #include "unicode/fieldpos.h"
16 #include "unicode/formattedvalue.h"
17 #include "unicode/fpositer.h"
18 #include "unicode/numberformatter.h"
19 #include "unicode/unumberrangeformatter.h"
20
48 U_NAMESPACE_BEGIN
49
50 // Forward declarations:
51 class PluralRules;
52
53 namespace number { // icu::number
54
55 // Forward declarations:
56 class UnlocalizedNumberRangeFormatter;
57 class LocalizedNumberRangeFormatter;
58 class FormattedNumberRange;
59
60 namespace impl {
61
62 // Forward declarations:
63 struct RangeMacroProps;
64 class DecimalQuantity;
65 class UFormattedNumberRangeData;
66 class NumberRangeFormatterImpl;
67 struct UFormattedNumberRangeImpl;
68
69 } // namespace impl
70
76 #if U_PLATFORM == U_PF_WINDOWS && !defined(U_IN_DOXYGEN) && !defined(U_STATIC_IMPLEMENTATION)
77 } // namespace icu::number
78 U_NAMESPACE_END
79
80 template struct U_I18N_API std::atomic< U_NAMESPACE_QUALIFIER number::impl::NumberRangeFormatterImpl*>;
81
82 U_NAMESPACE_BEGIN
83 namespace number { // icu::number
84 #endif
87 // Other helper classes would go here, but there are none.
88
89 namespace impl { // icu::number::impl
90
91 // Do not enclose entire MacroProps with #ifndef U_HIDE_INTERNAL_API, needed for a protected field
93 struct U_I18N_API RangeMacroProps : public UMemory {
95 UnlocalizedNumberFormatter formatter1; // = NumberFormatter::with();
96
98 UnlocalizedNumberFormatter formatter2; // = NumberFormatter::with();
99
101 bool singleFormatter = true;
102
104 UNumberRangeCollapse collapse = UNUM_RANGE_COLLAPSE_AUTO;
105
107 UNumberRangeIdentityFallback identityFallback = UNUM_IDENTITY_FALLBACK_APPROXIMATELY;
108
110 Locale locale;
111
112 // NOTE: Uses default copy and move constructors.
113
118 bool copyErrorTo(UErrorCode &status) const {
119 return formatter1.copyErrorTo(status) || formatter2.copyErrorTo(status);
120 }
121 };
122
123 } // namespace impl
124
130 template<typename Derived>
131 class U_I18N_API NumberRangeFormatterSettings {
132 public:
145 Derived numberFormatterBoth(const UnlocalizedNumberFormatter &formatter) const &;
146
156 Derived numberFormatterBoth(const UnlocalizedNumberFormatter &formatter) &&;
157
167 Derived numberFormatterBoth(UnlocalizedNumberFormatter &&formatter) const &;
168
178 Derived numberFormatterBoth(UnlocalizedNumberFormatter &&formatter) &&;
179
191 Derived numberFormatterFirst(const UnlocalizedNumberFormatter &formatterFirst) const &;
192
202 Derived numberFormatterFirst(const UnlocalizedNumberFormatter &formatterFirst) &&;
203
213 Derived numberFormatterFirst(UnlocalizedNumberFormatter &&formatterFirst) const &;
214
224 Derived numberFormatterFirst(UnlocalizedNumberFormatter &&formatterFirst) &&;
225
237 Derived numberFormatterSecond(const UnlocalizedNumberFormatter &formatterSecond) const &;
238
248 Derived numberFormatterSecond(const UnlocalizedNumberFormatter &formatterSecond) &&;
249
259 Derived numberFormatterSecond(UnlocalizedNumberFormatter &&formatterSecond) const &;
260
270 Derived numberFormatterSecond(UnlocalizedNumberFormatter &&formatterSecond) &&;
271
289 Derived collapse(UNumberRangeCollapse collapse) const &;
290
300 Derived collapse(UNumberRangeCollapse collapse) &&;
301
322 Derived identityFallback(UNumberRangeIdentityFallback identityFallback) const &;
323
333 Derived identityFallback(UNumberRangeIdentityFallback identityFallback) &&;
334
346 LocalPointer<Derived> clone() const &;
347
355 LocalPointer<Derived> clone() &&;
356
363 UBool copyErrorTo(UErrorCode &outErrorCode) const {
364 if (U_FAILURE(outErrorCode)) {
365 // Do not overwrite the older error code
366 return true;
367 }
368 fMacros.copyErrorTo(outErrorCode);
369 return U_FAILURE(outErrorCode);
370 }
371
372 // NOTE: Uses default copy and move constructors.
373
374 private:
375 impl::RangeMacroProps fMacros;
376
377 // Don't construct me directly! Use (Un)LocalizedNumberFormatter.
378 NumberRangeFormatterSettings() = default;
379
380 friend class LocalizedNumberRangeFormatter;
381 friend class UnlocalizedNumberRangeFormatter;
382 };
383
384 // Explicit instantiations in source/i18n/numrange_fluent.cpp.
385 // (MSVC treats imports/exports of explicit instantiations differently.)
386 #ifndef _MSC_VER
387 extern template class NumberRangeFormatterSettings<UnlocalizedNumberRangeFormatter>;
388 extern template class NumberRangeFormatterSettings<LocalizedNumberRangeFormatter>;
389 #endif
390
399 class U_I18N_API UnlocalizedNumberRangeFormatter
400 : public NumberRangeFormatterSettings<UnlocalizedNumberRangeFormatter>, public UMemory {
401
402 public:
412 LocalizedNumberRangeFormatter locale(const icu::Locale &locale) const &;
413
423 LocalizedNumberRangeFormatter locale(const icu::Locale &locale) &&;
424
430 UnlocalizedNumberRangeFormatter() = default;
431
436 UnlocalizedNumberRangeFormatter(const UnlocalizedNumberRangeFormatter &other);
437
443 UnlocalizedNumberRangeFormatter(UnlocalizedNumberRangeFormatter&& src) noexcept;
444
449 UnlocalizedNumberRangeFormatter& operator=(const UnlocalizedNumberRangeFormatter& other);
450
456 UnlocalizedNumberRangeFormatter& operator=(UnlocalizedNumberRangeFormatter&& src) noexcept;
457
458 private:
459 explicit UnlocalizedNumberRangeFormatter(
460 const NumberRangeFormatterSettings<UnlocalizedNumberRangeFormatter>& other);
461
462 explicit UnlocalizedNumberRangeFormatter(
463 NumberRangeFormatterSettings<UnlocalizedNumberRangeFormatter>&& src) noexcept;
464
465 // To give the fluent setters access to this class's constructor:
466 friend class NumberRangeFormatterSettings<UnlocalizedNumberRangeFormatter>;
467
468 // To give NumberRangeFormatter::with() access to this class's constructor:
469 friend class NumberRangeFormatter;
470 };
471
480 class U_I18N_API LocalizedNumberRangeFormatter
481 : public NumberRangeFormatterSettings<LocalizedNumberRangeFormatter>, public UMemory {
482 public:
496 FormattedNumberRange formatFormattableRange(
497 const Formattable& first, const Formattable& second, UErrorCode& status) const;
498
504 LocalizedNumberRangeFormatter() = default;
505
510 LocalizedNumberRangeFormatter(const LocalizedNumberRangeFormatter &other);
511
517 LocalizedNumberRangeFormatter(LocalizedNumberRangeFormatter&& src) noexcept;
518
523 LocalizedNumberRangeFormatter& operator=(const LocalizedNumberRangeFormatter& other);
524
530 LocalizedNumberRangeFormatter& operator=(LocalizedNumberRangeFormatter&& src) noexcept;
531
532 #ifndef U_HIDE_INTERNAL_API
533
544 void formatImpl(impl::UFormattedNumberRangeData& results, bool equalBeforeRounding,
545 UErrorCode& status) const;
546
547 #endif /* U_HIDE_INTERNAL_API */
548
553 ~LocalizedNumberRangeFormatter();
554
555 private:
556 std::atomic<impl::NumberRangeFormatterImpl*> fAtomicFormatter = {};
557
558 const impl::NumberRangeFormatterImpl* getFormatter(UErrorCode& stauts) const;
559
560 explicit LocalizedNumberRangeFormatter(
561 const NumberRangeFormatterSettings<LocalizedNumberRangeFormatter>& other);
562
563 explicit LocalizedNumberRangeFormatter(
564 NumberRangeFormatterSettings<LocalizedNumberRangeFormatter>&& src) noexcept;
565
566 LocalizedNumberRangeFormatter(const impl::RangeMacroProps &macros, const Locale &locale);
567
568 LocalizedNumberRangeFormatter(impl::RangeMacroProps &&macros, const Locale &locale);
569
570 // To give the fluent setters access to this class's constructor:
571 friend class NumberRangeFormatterSettings<UnlocalizedNumberRangeFormatter>;
572 friend class NumberRangeFormatterSettings<LocalizedNumberRangeFormatter>;
573
574 // To give UnlocalizedNumberRangeFormatter::locale() access to this class's constructor:
575 friend class UnlocalizedNumberRangeFormatter;
576 };
577
586 class U_I18N_API FormattedNumberRange : public UMemory, public FormattedValue {
587 public:
588 // Copybrief: this method is older than the parent method
596 UnicodeString toString(UErrorCode& status) const override;
597
598 // Copydoc: this method is new in ICU 64
600 UnicodeString toTempString(UErrorCode& status) const override;
601
602 // Copybrief: this method is older than the parent method
610 Appendable &appendTo(Appendable &appendable, UErrorCode& status) const override;
611
612 // Copydoc: this method is new in ICU 64
614 UBool nextPosition(ConstrainedFieldPosition& cfpos, UErrorCode& status) const override;
615
635 template<typename StringClass>
636 inline std::pair<StringClass, StringClass> getDecimalNumbers(UErrorCode& status) const;
637
647 UNumberRangeIdentityResult getIdentityResult(UErrorCode& status) const;
648
653 FormattedNumberRange()
654 : fData(nullptr), fErrorCode(U_INVALID_STATE_ERROR) {}
655
659 FormattedNumberRange(const FormattedNumberRange&) = delete;
660
664 FormattedNumberRange& operator=(const FormattedNumberRange&) = delete;
665
671 FormattedNumberRange(FormattedNumberRange&& src) noexcept;
672
678 FormattedNumberRange& operator=(FormattedNumberRange&& src) noexcept;
679
684 ~FormattedNumberRange();
685
686 private:
687 // Can't use LocalPointer because UFormattedNumberRangeData is forward-declared
688 const impl::UFormattedNumberRangeData *fData;
689
690 // Error code for the terminal methods
691 UErrorCode fErrorCode;
692
696 explicit FormattedNumberRange(impl::UFormattedNumberRangeData *results)
697 : fData(results), fErrorCode(U_ZERO_ERROR) {}
698
699 explicit FormattedNumberRange(UErrorCode errorCode)
700 : fData(nullptr), fErrorCode(errorCode) {}
701
702 void getDecimalNumbers(ByteSink& sink1, ByteSink& sink2, UErrorCode& status) const;
703
704 const impl::UFormattedNumberRangeData* getData(UErrorCode& status) const;
705
706 // To allow PluralRules to access the underlying data
707 friend class ::icu::PluralRules;
708
709 // To give LocalizedNumberRangeFormatter format methods access to this class's constructor:
710 friend class LocalizedNumberRangeFormatter;
711
712 // To give C API access to internals
713 friend struct impl::UFormattedNumberRangeImpl;
714 };
715
716 // inline impl of @stable ICU 68 method
717 template<typename StringClass>
718 std::pair<StringClass, StringClass> FormattedNumberRange::getDecimalNumbers(UErrorCode& status) const {
719 StringClass str1;
720 StringClass str2;
721 StringByteSink<StringClass> sink1(&str1);
722 StringByteSink<StringClass> sink2(&str2);
723 getDecimalNumbers(sink1, sink2, status);
724 return std::make_pair(str1, str2);
725 }
726
732 class U_I18N_API NumberRangeFormatter final {
733 public:
741 static UnlocalizedNumberRangeFormatter with();
742
752 static LocalizedNumberRangeFormatter withLocale(const Locale &locale);
753
757 NumberRangeFormatter() = delete;
758 };
759
760 } // namespace number
761 U_NAMESPACE_END
762
763 #endif /* #if !UCONFIG_NO_FORMATTING */
764
765 #endif /* U_SHOW_CPLUSPLUS_API */
766
767 #endif // __NUMBERRANGEFORMATTER_H__
768
appendable.h
C++ API: Appendable class: Sink for Unicode code points and 16-bit code units (char16_ts).
icu::Appendable
Base class for objects to which Unicode characters and strings can be appended.
Definition: appendable.h:54
icu::ByteSink
A ByteSink can be filled with bytes.
Definition: bytestream.h:53
icu::ConstrainedFieldPosition
Represents a span of a string containing a given field.
Definition: formattedvalue.h:41
icu::Formattable
Formattable objects can be passed to the Format class or its subclasses for formatting.
Definition: fmtable.h:64
icu::FormattedValue
An abstract formatted value: a string with associated field attributes.
Definition: formattedvalue.h:241
icu::LocalPointer
"Smart pointer" class, deletes objects via the standard C++ delete operator.
Definition: localpointer.h:191
icu::Locale
A Locale object represents a specific geographical, political, or cultural region.
Definition: locid.h:195
icu::StringByteSink
Implementation of ByteSink that writes to a "string".
Definition: bytestream.h:267
icu::UMemory
UMemory is the common ICU base class.
Definition: uobject.h:115
icu::UnicodeString
UnicodeString is a string class that stores Unicode characters directly and provides similar function...
Definition: unistr.h:296
icu::number::FormattedNumberRange
The result of a number range formatting operation.
Definition: numberrangeformatter.h:586
icu::number::FormattedNumberRange::toTempString
UnicodeString toTempString(UErrorCode &status) const override
Returns the formatted string as a read-only alias to memory owned by the FormattedValue.
icu::number::FormattedNumberRange::toString
UnicodeString toString(UErrorCode &status) const override
Returns the formatted string as a self-contained UnicodeString.
icu::number::FormattedNumberRange::FormattedNumberRange
FormattedNumberRange(const FormattedNumberRange &)=delete
Copying not supported; use move constructor instead.
icu::number::FormattedNumberRange::nextPosition
UBool nextPosition(ConstrainedFieldPosition &cfpos, UErrorCode &status) const override
Iterates over field positions in the FormattedValue.
icu::number::FormattedNumberRange::getIdentityResult
UNumberRangeIdentityResult getIdentityResult(UErrorCode &status) const
Returns whether the pair of numbers was successfully formatted as a range or whether an identity fall...
icu::number::FormattedNumberRange::appendTo
Appendable & appendTo(Appendable &appendable, UErrorCode &status) const override
Appends the formatted string to an Appendable.
icu::number::FormattedNumberRange::FormattedNumberRange
FormattedNumberRange(FormattedNumberRange &&src) noexcept
Move constructor: Leaves the source FormattedNumberRange in an undefined state.
icu::number::FormattedNumberRange::FormattedNumberRange
FormattedNumberRange()
Default constructor; makes an empty FormattedNumberRange.
Definition: numberrangeformatter.h:653
icu::number::FormattedNumberRange::operator=
FormattedNumberRange & operator=(const FormattedNumberRange &)=delete
Copying not supported; use move assignment instead.
icu::number::FormattedNumberRange::~FormattedNumberRange
~FormattedNumberRange()
Destruct an instance of FormattedNumberRange, cleaning up any memory it might own.
icu::number::FormattedNumberRange::operator=
FormattedNumberRange & operator=(FormattedNumberRange &&src) noexcept
Move assignment: Leaves the source FormattedNumberRange in an undefined state.
icu::number::LocalizedNumberRangeFormatter
A NumberRangeFormatter that has a locale associated with it; this means .formatRange() methods are av...
Definition: numberrangeformatter.h:481
icu::number::LocalizedNumberRangeFormatter::formatFormattableRange
FormattedNumberRange formatFormattableRange(const Formattable &first, const Formattable &second, UErrorCode &status) const
Format the given Formattables to a string using the settings specified in the NumberRangeFormatter fl...
icu::number::LocalizedNumberRangeFormatter::operator=
LocalizedNumberRangeFormatter & operator=(const LocalizedNumberRangeFormatter &other)
Copy assignment operator.
icu::number::LocalizedNumberRangeFormatter::LocalizedNumberRangeFormatter
LocalizedNumberRangeFormatter()=default
Default constructor: puts the formatter into a valid but undefined state.
icu::number::LocalizedNumberRangeFormatter::LocalizedNumberRangeFormatter
LocalizedNumberRangeFormatter(const LocalizedNumberRangeFormatter &other)
Returns a copy of this LocalizedNumberRangeFormatter.
icu::number::LocalizedNumberRangeFormatter::operator=
LocalizedNumberRangeFormatter & operator=(LocalizedNumberRangeFormatter &&src) noexcept
Move assignment operator: The source LocalizedNumberRangeFormatter will be left in a valid but undefi...
icu::number::LocalizedNumberRangeFormatter::formatImpl
void formatImpl(impl::UFormattedNumberRangeData &results, bool equalBeforeRounding, UErrorCode &status) const
icu::number::LocalizedNumberRangeFormatter::~LocalizedNumberRangeFormatter
~LocalizedNumberRangeFormatter()
Destruct this LocalizedNumberRangeFormatter, cleaning up any memory it might own.
icu::number::LocalizedNumberRangeFormatter::LocalizedNumberRangeFormatter
LocalizedNumberRangeFormatter(LocalizedNumberRangeFormatter &&src) noexcept
Move constructor: The source LocalizedNumberRangeFormatter will be left in a valid but undefined stat...
icu::number::NumberFormatterSettings::copyErrorTo
UBool copyErrorTo(UErrorCode &outErrorCode) const
Sets the UErrorCode if an error occurred in the fluent chain.
Definition: numberformatter.h:2395
icu::number::NumberRangeFormatterSettings
An abstract base class for specifying settings related to number formatting.
Definition: numberrangeformatter.h:131
icu::number::NumberRangeFormatterSettings::numberFormatterSecond
Derived numberFormatterSecond(UnlocalizedNumberFormatter &&formatterSecond) &&
Overload of numberFormatterSecond() for use on an rvalue reference.
icu::number::NumberRangeFormatterSettings::numberFormatterFirst
Derived numberFormatterFirst(UnlocalizedNumberFormatter &&formatterFirst) const &
Overload of numberFormatterFirst() for use on an rvalue reference.
icu::number::NumberRangeFormatterSettings::numberFormatterBoth
Derived numberFormatterBoth(const UnlocalizedNumberFormatter &formatter) &&
Overload of numberFormatterBoth() for use on an rvalue reference.
icu::number::NumberRangeFormatterSettings::numberFormatterFirst
Derived numberFormatterFirst(UnlocalizedNumberFormatter &&formatterFirst) &&
Overload of numberFormatterFirst() for use on an rvalue reference.
icu::number::NumberRangeFormatterSettings::numberFormatterBoth
Derived numberFormatterBoth(UnlocalizedNumberFormatter &&formatter) &&
Overload of numberFormatterBoth() for use on an rvalue reference.
icu::number::NumberRangeFormatterSettings::numberFormatterBoth
Derived numberFormatterBoth(const UnlocalizedNumberFormatter &formatter) const &
Sets the NumberFormatter instance to use for the numbers in the range.
icu::number::NumberRangeFormatterSettings::numberFormatterBoth
Derived numberFormatterBoth(UnlocalizedNumberFormatter &&formatter) const &
Overload of numberFormatterBoth() for use on an rvalue reference.
icu::number::NumberRangeFormatterSettings::numberFormatterFirst
Derived numberFormatterFirst(const UnlocalizedNumberFormatter &formatterFirst) &&
Overload of numberFormatterFirst() for use on an rvalue reference.
icu::number::NumberRangeFormatterSettings::identityFallback
Derived identityFallback(UNumberRangeIdentityFallback identityFallback) const &
Sets the behavior when the two sides of the range are the same.
icu::number::NumberRangeFormatterSettings::numberFormatterFirst
Derived numberFormatterFirst(const UnlocalizedNumberFormatter &formatterFirst) const &
Sets the NumberFormatter instance to use for the first number in the range.
icu::number::NumberRangeFormatterSettings::numberFormatterSecond
Derived numberFormatterSecond(UnlocalizedNumberFormatter &&formatterSecond) const &
Overload of numberFormatterSecond() for use on an rvalue reference.
icu::number::NumberRangeFormatterSettings::collapse
Derived collapse(UNumberRangeCollapse collapse) &&
Overload of collapse() for use on an rvalue reference.
icu::number::NumberRangeFormatterSettings::numberFormatterSecond
Derived numberFormatterSecond(const UnlocalizedNumberFormatter &formatterSecond) const &
Sets the NumberFormatter instance to use for the second number in the range.
icu::number::NumberRangeFormatterSettings::collapse
Derived collapse(UNumberRangeCollapse collapse) const &
Sets the aggressiveness of "collapsing" fields across the range separator.
icu::number::NumberRangeFormatterSettings::identityFallback
Derived identityFallback(UNumberRangeIdentityFallback identityFallback) &&
Overload of identityFallback() for use on an rvalue reference.
icu::number::NumberRangeFormatterSettings::numberFormatterSecond
Derived numberFormatterSecond(const UnlocalizedNumberFormatter &formatterSecond) &&
Overload of numberFormatterSecond() for use on an rvalue reference.
icu::number::NumberRangeFormatterSettings::clone
LocalPointer< Derived > clone() const &
Returns the current (Un)LocalizedNumberRangeFormatter as a LocalPointer wrapping a heap-allocated cop...
icu::number::NumberRangeFormatter
See the main description in numberrangeformatter.h for documentation and examples.
Definition: numberrangeformatter.h:732
icu::number::NumberRangeFormatter::with
static UnlocalizedNumberRangeFormatter with()
Call this method at the beginning of a NumberRangeFormatter fluent chain in which the locale is not c...
icu::number::NumberRangeFormatter::NumberRangeFormatter
NumberRangeFormatter()=delete
Use factory methods instead of the constructor to create a NumberFormatter.
icu::number::NumberRangeFormatter::withLocale
static LocalizedNumberRangeFormatter withLocale(const Locale &locale)
Call this method at the beginning of a NumberRangeFormatter fluent chain in which the locale is known...
icu::number::UnlocalizedNumberFormatter
A NumberFormatter that does not yet have a locale.
Definition: numberformatter.h:2436
icu::number::UnlocalizedNumberRangeFormatter
A NumberRangeFormatter that does not yet have a locale.
Definition: numberrangeformatter.h:400
icu::number::UnlocalizedNumberRangeFormatter::UnlocalizedNumberRangeFormatter
UnlocalizedNumberRangeFormatter(const UnlocalizedNumberRangeFormatter &other)
Returns a copy of this UnlocalizedNumberRangeFormatter.
icu::number::UnlocalizedNumberRangeFormatter::operator=
UnlocalizedNumberRangeFormatter & operator=(UnlocalizedNumberRangeFormatter &&src) noexcept
Move assignment operator: The source UnlocalizedNumberRangeFormatter will be left in a valid but unde...
icu::number::UnlocalizedNumberRangeFormatter::locale
LocalizedNumberRangeFormatter locale(const icu::Locale &locale) const &
Associate the given locale with the number range formatter.
icu::number::UnlocalizedNumberRangeFormatter::locale
LocalizedNumberRangeFormatter locale(const icu::Locale &locale) &&
Overload of locale() for use on an rvalue reference.
icu::number::UnlocalizedNumberRangeFormatter::operator=
UnlocalizedNumberRangeFormatter & operator=(const UnlocalizedNumberRangeFormatter &other)
Copy assignment operator.
icu::number::UnlocalizedNumberRangeFormatter::UnlocalizedNumberRangeFormatter
UnlocalizedNumberRangeFormatter(UnlocalizedNumberRangeFormatter &&src) noexcept
Move constructor: The source UnlocalizedNumberRangeFormatter will be left in a valid but undefined st...
icu::number::UnlocalizedNumberRangeFormatter::UnlocalizedNumberRangeFormatter
UnlocalizedNumberRangeFormatter()=default
Default constructor: puts the formatter into a valid but undefined state.
fieldpos.h
C++ API: FieldPosition identifies the fields in a formatted output.
formattedvalue.h
C++ API: Abstract operations for localized strings.
fpositer.h
C++ API: FieldPosition Iterator.
numberformatter.h
C++ API: All-in-one formatter for localized numbers, currencies, and units.
icu::number::impl::RangeMacroProps
Definition: numberrangeformatter.h:93
icu::number::impl::RangeMacroProps::locale
Locale locale
Definition: numberrangeformatter.h:110
icu::number::impl::RangeMacroProps::formatter2
UnlocalizedNumberFormatter formatter2
Definition: numberrangeformatter.h:98
icu::number::impl::RangeMacroProps::formatter1
UnlocalizedNumberFormatter formatter1
Definition: numberrangeformatter.h:95
icu::number::impl::RangeMacroProps::copyErrorTo
bool copyErrorTo(UErrorCode &status) const
Check all members for errors.
Definition: numberrangeformatter.h:118
UBool
int8_t UBool
The ICU boolean type, a signed-byte integer.
Definition: umachine.h:247
unumberrangeformatter.h
C API: Localized number range formatting.
UNumberRangeIdentityResult
UNumberRangeIdentityResult
Used in the result class FormattedNumberRange to indicate to the user whether the numbers formatted i...
Definition: unumberrangeformatter.h:165
UNumberRangeIdentityFallback
UNumberRangeIdentityFallback
Defines the behavior when the two numbers in the range are identical after rounding.
Definition: unumberrangeformatter.h:125
UNUM_IDENTITY_FALLBACK_APPROXIMATELY
@ UNUM_IDENTITY_FALLBACK_APPROXIMATELY
Show the number using a locale-sensitive approximation pattern.
Definition: unumberrangeformatter.h:147
UNumberRangeCollapse
UNumberRangeCollapse
Defines how to merge fields that are identical across the range sign.
Definition: unumberrangeformatter.h:83
UNUM_RANGE_COLLAPSE_AUTO
@ UNUM_RANGE_COLLAPSE_AUTO
Use locale data and heuristics to determine how much of the string to collapse.
Definition: unumberrangeformatter.h:92
utypes.h
Basic definitions for ICU, for both C and C++ APIs.
UErrorCode
UErrorCode
Standard ICU4C error code type, a substitute for exceptions.
Definition: utypes.h:415
U_INVALID_STATE_ERROR
@ U_INVALID_STATE_ERROR
Requested operation can not be completed with ICU in its current state.
Definition: utypes.h:478
U_ZERO_ERROR
@ U_ZERO_ERROR
No error, no warning.
Definition: utypes.h:449
U_FAILURE
#define U_FAILURE(x)
Does the error code indicate a failure?
Definition: utypes.h:717
U_I18N_API
#define U_I18N_API
Set to export library symbols from inside the i18n library, and to import them from outside.
Definition: utypes.h:301