ICU 76.1: i18n/unicode/numberrangeformatter.h Source File

ICU 76.1 76.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
48U_NAMESPACE_BEGIN
49
50// Forward declarations:
51class PluralRules;
52
53namespace number { // icu::number
54
55// Forward declarations:
56class UnlocalizedNumberRangeFormatter;
57class LocalizedNumberRangeFormatter;
58class FormattedNumberRange;
59
60namespace impl {
61
62// Forward declarations:
63struct RangeMacroProps;
64class DecimalQuantity;
65class UFormattedNumberRangeData;
66class NumberRangeFormatterImpl;
67struct 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
78U_NAMESPACE_END
79
80template struct U_I18N_API std::atomic< U_NAMESPACE_QUALIFIER number::impl::NumberRangeFormatterImpl*>;
81
82U_NAMESPACE_BEGIN
83namespace number { // icu::number
84#endif
87// Other helper classes would go here, but there are none.
88
89namespace 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
130template<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
387extern template class NumberRangeFormatterSettings<UnlocalizedNumberRangeFormatter>;
388extern 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 explicit UnlocalizedNumberRangeFormatter(const impl::RangeMacroProps &macros);
466
467 explicit UnlocalizedNumberRangeFormatter(impl::RangeMacroProps &&macros);
468
469 // To give the fluent setters access to this class's constructor:
470 friend class NumberRangeFormatterSettings<UnlocalizedNumberRangeFormatter>;
471
472 // To give NumberRangeFormatter::with() access to this class's constructor:
473 friend class NumberRangeFormatter;
474
475 // To give LNRF::withoutLocale() access to this class's constructor:
476 friend class LocalizedNumberRangeFormatter;
477};
478
487 class U_I18N_API LocalizedNumberRangeFormatter
488 : public NumberRangeFormatterSettings<LocalizedNumberRangeFormatter>, public UMemory {
489 public:
503 FormattedNumberRange formatFormattableRange(
504 const Formattable& first, const Formattable& second, UErrorCode& status) const;
505
506#ifndef U_HIDE_DRAFT_API
513 UnlocalizedNumberRangeFormatter withoutLocale() const &;
514
522 UnlocalizedNumberRangeFormatter withoutLocale() &&;
523#endif // U_HIDE_DRAFT_API
524
530 LocalizedNumberRangeFormatter() = default;
531
536 LocalizedNumberRangeFormatter(const LocalizedNumberRangeFormatter &other);
537
543 LocalizedNumberRangeFormatter(LocalizedNumberRangeFormatter&& src) noexcept;
544
549 LocalizedNumberRangeFormatter& operator=(const LocalizedNumberRangeFormatter& other);
550
556 LocalizedNumberRangeFormatter& operator=(LocalizedNumberRangeFormatter&& src) noexcept;
557
558#ifndef U_HIDE_INTERNAL_API
559
570 void formatImpl(impl::UFormattedNumberRangeData& results, bool equalBeforeRounding,
571 UErrorCode& status) const;
572
573#endif /* U_HIDE_INTERNAL_API */
574
579 ~LocalizedNumberRangeFormatter();
580
581 private:
582 std::atomic<impl::NumberRangeFormatterImpl*> fAtomicFormatter = {};
583
584 const impl::NumberRangeFormatterImpl* getFormatter(UErrorCode& stauts) const;
585
586 explicit LocalizedNumberRangeFormatter(
587 const NumberRangeFormatterSettings<LocalizedNumberRangeFormatter>& other);
588
589 explicit LocalizedNumberRangeFormatter(
590 NumberRangeFormatterSettings<LocalizedNumberRangeFormatter>&& src) noexcept;
591
592 LocalizedNumberRangeFormatter(const impl::RangeMacroProps &macros, const Locale &locale);
593
594 LocalizedNumberRangeFormatter(impl::RangeMacroProps &&macros, const Locale &locale);
595
596 // To give the fluent setters access to this class's constructor:
597 friend class NumberRangeFormatterSettings<UnlocalizedNumberRangeFormatter>;
598 friend class NumberRangeFormatterSettings<LocalizedNumberRangeFormatter>;
599
600 // To give UnlocalizedNumberRangeFormatter::locale() access to this class's constructor:
601 friend class UnlocalizedNumberRangeFormatter;
602};
603
612 class U_I18N_API FormattedNumberRange : public UMemory, public FormattedValue {
613 public:
614 // Copybrief: this method is older than the parent method
622 UnicodeString toString(UErrorCode& status) const override;
623
624 // Copydoc: this method is new in ICU 64
626 UnicodeString toTempString(UErrorCode& status) const override;
627
628 // Copybrief: this method is older than the parent method
636 Appendable &appendTo(Appendable &appendable, UErrorCode& status) const override;
637
638 // Copydoc: this method is new in ICU 64
640 UBool nextPosition(ConstrainedFieldPosition& cfpos, UErrorCode& status) const override;
641
661 template<typename StringClass>
662 inline std::pair<StringClass, StringClass> getDecimalNumbers(UErrorCode& status) const;
663
673 UNumberRangeIdentityResult getIdentityResult(UErrorCode& status) const;
674
679 FormattedNumberRange()
680 : fData(nullptr), fErrorCode(U_INVALID_STATE_ERROR) {}
681
685 FormattedNumberRange(const FormattedNumberRange&) = delete;
686
690 FormattedNumberRange& operator=(const FormattedNumberRange&) = delete;
691
697 FormattedNumberRange(FormattedNumberRange&& src) noexcept;
698
704 FormattedNumberRange& operator=(FormattedNumberRange&& src) noexcept;
705
710 ~FormattedNumberRange();
711
712 private:
713 // Can't use LocalPointer because UFormattedNumberRangeData is forward-declared
714 const impl::UFormattedNumberRangeData *fData;
715
716 // Error code for the terminal methods
717 UErrorCode fErrorCode;
718
722 explicit FormattedNumberRange(impl::UFormattedNumberRangeData *results)
723 : fData(results), fErrorCode(U_ZERO_ERROR) {}
724
725 explicit FormattedNumberRange(UErrorCode errorCode)
726 : fData(nullptr), fErrorCode(errorCode) {}
727
728 void getDecimalNumbers(ByteSink& sink1, ByteSink& sink2, UErrorCode& status) const;
729
730 const impl::UFormattedNumberRangeData* getData(UErrorCode& status) const;
731
732 // To allow PluralRules to access the underlying data
733 friend class ::icu::PluralRules;
734
735 // To give LocalizedNumberRangeFormatter format methods access to this class's constructor:
736 friend class LocalizedNumberRangeFormatter;
737
738 // To give C API access to internals
739 friend struct impl::UFormattedNumberRangeImpl;
740};
741
742// inline impl of @stable ICU 68 method
743template<typename StringClass>
744std::pair<StringClass, StringClass> FormattedNumberRange::getDecimalNumbers(UErrorCode& status) const {
745 StringClass str1;
746 StringClass str2;
747 StringByteSink<StringClass> sink1(&str1);
748 StringByteSink<StringClass> sink2(&str2);
749 getDecimalNumbers(sink1, sink2, status);
750 return std::make_pair(str1, str2);
751}
752
758 class U_I18N_API NumberRangeFormatter final {
759 public:
767 static UnlocalizedNumberRangeFormatter with();
768
778 static LocalizedNumberRangeFormatter withLocale(const Locale &locale);
779
783 NumberRangeFormatter() = delete;
784};
785
786} // namespace number
787U_NAMESPACE_END
788
789#endif /* #if !UCONFIG_NO_FORMATTING */
790
791#endif /* U_SHOW_CPLUSPLUS_API */
792
793#endif // __NUMBERRANGEFORMATTER_H__
794
appendable.h
C++ API: Appendable class: Sink for Unicode code points and 16-bit code units (char16_ts).
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:63
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:612
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:679
icu::number::FormattedNumberRange::operator=
FormattedNumberRange & operator=(FormattedNumberRange &&src) noexcept
Move assignment: Leaves the source FormattedNumberRange in an undefined state.
icu::number::FormattedNumberRange::~FormattedNumberRange
~FormattedNumberRange()
Destruct an instance of FormattedNumberRange, cleaning up any memory it might own.
icu::number::FormattedNumberRange::operator=
FormattedNumberRange & operator=(const FormattedNumberRange &)=delete
Copying not supported; use move assignment instead.
icu::number::LocalizedNumberRangeFormatter
A NumberRangeFormatter that has a locale associated with it; this means .formatRange() methods are av...
Definition numberrangeformatter.h:488
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::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::LocalizedNumberRangeFormatter::operator=
LocalizedNumberRangeFormatter & operator=(LocalizedNumberRangeFormatter &&src) noexcept
Move assignment operator: The source LocalizedNumberRangeFormatter will be left in a valid but undefi...
icu::number::LocalizedNumberRangeFormatter::withoutLocale
UnlocalizedNumberRangeFormatter withoutLocale() const &
Disassociate the locale from this formatter.
icu::number::NumberFormatterSettings::copyErrorTo
UBool copyErrorTo(UErrorCode &outErrorCode) const
Sets the UErrorCode if an error occurred in the fluent chain.
Definition numberformatter.h:2393
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::clone
LocalPointer< Derived > clone() const &
Returns the current (Un)LocalizedNumberRangeFormatter as a LocalPointer wrapping a heap-allocated cop...
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::NumberRangeFormatter
See the main description in numberrangeformatter.h for documentation and examples.
Definition numberrangeformatter.h:758
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:2434
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::locale
LocalizedNumberRangeFormatter locale(const icu::Locale &locale) const &
Associate the given locale with the number range formatter.
icu::number::UnlocalizedNumberRangeFormatter::operator=
UnlocalizedNumberRangeFormatter & operator=(const UnlocalizedNumberRangeFormatter &other)
Copy assignment operator.
icu::number::UnlocalizedNumberRangeFormatter::locale
LocalizedNumberRangeFormatter locale(const icu::Locale &locale) &&
Overload of locale() for use on an rvalue reference.
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.
icu::number::UnlocalizedNumberRangeFormatter::operator=
UnlocalizedNumberRangeFormatter & operator=(UnlocalizedNumberRangeFormatter &&src) noexcept
Move assignment operator: The source UnlocalizedNumberRangeFormatter will be left in a valid but unde...
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:430
U_INVALID_STATE_ERROR
@ U_INVALID_STATE_ERROR
Requested operation can not be completed with ICU in its current state.
Definition utypes.h:494
U_ZERO_ERROR
@ U_ZERO_ERROR
No error, no warning.
Definition utypes.h:465
U_FAILURE
#define U_FAILURE(x)
Does the error code indicate a failure?
Definition utypes.h:747
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:316