ICU 74.1 74.1
simplenumberformatter.h
Go to the documentation of this file.
1// © 2022 and later: Unicode, Inc. and others.
2// License & terms of use: http://www.unicode.org/copyright.html
3
4#ifndef __SIMPLENUMBERFORMATTERH__
5#define __SIMPLENUMBERFORMATTERH__
6
7#include "unicode/utypes.h"
8
9#if U_SHOW_CPLUSPLUS_API
10
11#if !UCONFIG_NO_FORMATTING
12
13#include "unicode/dcfmtsym.h"
16
31U_NAMESPACE_BEGIN
32
33
34namespace number { // icu::number
35
36
37namespace impl {
38class UFormattedNumberData;
39struct SimpleMicroProps;
40class AdoptingSignumModifierStore;
41} // icu::number::impl
42
43
44#ifndef U_HIDE_DRAFT_API
45
46
55 public:
61 static SimpleNumber forInt64(int64_t value, UErrorCode& status);
62
70 void multiplyByPowerOfTen(int32_t power, UErrorCode& status);
71
79 void roundTo(int32_t power, UNumberFormatRoundingMode roundingMode, UErrorCode& status);
80
88 void truncateStart(uint32_t maximumIntegerDigits, UErrorCode& status);
89
97 void setMinimumIntegerDigits(uint32_t minimumIntegerDigits, UErrorCode& status);
98
106 void setMinimumFractionDigits(uint32_t minimumFractionDigits, UErrorCode& status);
107
118
126 SimpleNumber() = default;
127
134 cleanup();
135 }
136
142 SimpleNumber(SimpleNumber&& other) noexcept {
143 fData = other.fData;
144 fSign = other.fSign;
145 other.fData = nullptr;
146 }
147
154 cleanup();
155 fData = other.fData;
156 fSign = other.fSign;
157 other.fData = nullptr;
158 return *this;
159 }
160
161 private:
162 SimpleNumber(impl::UFormattedNumberData* data, UErrorCode& status);
163 SimpleNumber(const SimpleNumber&) = delete;
164 SimpleNumber& operator=(const SimpleNumber&) = delete;
165
166 void cleanup();
167
168 impl::UFormattedNumberData* fData = nullptr;
170
171 friend class SimpleNumberFormatter;
172};
173
174
186 public:
193 const icu::Locale &locale,
194 UErrorCode &status);
195
202 const icu::Locale &locale,
203 UNumberGroupingStrategy groupingStrategy,
204 UErrorCode &status);
205
215 const icu::Locale &locale,
216 const DecimalFormatSymbols &symbols,
217 UNumberGroupingStrategy groupingStrategy,
218 UErrorCode &status);
219
229
237 FormattedNumber formatInt64(int64_t value, UErrorCode &status) const {
238 return format(SimpleNumber::forInt64(value, status), status);
239 }
240
241#ifndef U_HIDE_INTERNAL_API
246 void formatImpl(impl::UFormattedNumberData* data, USimpleNumberSign sign, UErrorCode& status) const;
247#endif // U_HIDE_INTERNAL_API
248
255 cleanup();
256 }
257
264
271 fGroupingStrategy = other.fGroupingStrategy;
272 fOwnedSymbols = other.fOwnedSymbols;
273 fMicros = other.fMicros;
274 fPatternModifier = other.fPatternModifier;
275 other.fOwnedSymbols = nullptr;
276 other.fMicros = nullptr;
277 other.fPatternModifier = nullptr;
278 }
279
286 cleanup();
287 fGroupingStrategy = other.fGroupingStrategy;
288 fOwnedSymbols = other.fOwnedSymbols;
289 fMicros = other.fMicros;
290 fPatternModifier = other.fPatternModifier;
291 other.fOwnedSymbols = nullptr;
292 other.fMicros = nullptr;
293 other.fPatternModifier = nullptr;
294 return *this;
295 }
296
297 private:
298 void initialize(
299 const icu::Locale &locale,
300 const DecimalFormatSymbols &symbols,
301 UNumberGroupingStrategy groupingStrategy,
302 UErrorCode &status);
303
304 void cleanup();
305
307
308 SimpleNumberFormatter& operator=(const SimpleNumberFormatter&) = delete;
309
311
312 // Owned Pointers:
313 DecimalFormatSymbols* fOwnedSymbols = nullptr; // can be empty
314 impl::SimpleMicroProps* fMicros = nullptr;
315 impl::AdoptingSignumModifierStore* fPatternModifier = nullptr;
316};
317
318
319#endif // U_HIDE_DRAFT_API
320
321} // namespace number
322U_NAMESPACE_END
323
324#endif /* #if !UCONFIG_NO_FORMATTING */
325
326#endif /* U_SHOW_CPLUSPLUS_API */
327
328#endif // __SIMPLENUMBERFORMATTERH__
329
This class represents the set of symbols needed by DecimalFormat to format numbers.
Definition: dcfmtsym.h:86
A Locale object represents a specific geographical, political, or cultural region.
Definition: locid.h:195
UMemory is the common ICU base class.
Definition: uobject.h:115
The result of a number formatting operation.
A special NumberFormatter focused on smaller binary size and memory use.
FormattedNumber formatInt64(int64_t value, UErrorCode &status) const
Formats an integer using this SimpleNumberFormatter.
SimpleNumberFormatter(SimpleNumberFormatter &&other) noexcept
SimpleNumberFormatter: Move constructor.
SimpleNumberFormatter & operator=(SimpleNumberFormatter &&other) noexcept
SimpleNumberFormatter: Move assignment.
~SimpleNumberFormatter()
Destruct this SimpleNumberFormatter, cleaning up any memory it might own.
static SimpleNumberFormatter forLocaleAndGroupingStrategy(const icu::Locale &locale, UNumberGroupingStrategy groupingStrategy, UErrorCode &status)
Creates a new SimpleNumberFormatter, overriding the grouping strategy.
void formatImpl(impl::UFormattedNumberData *data, USimpleNumberSign sign, UErrorCode &status) const
Run the formatter with the internal types.
FormattedNumber format(SimpleNumber value, UErrorCode &status) const
Formats a value using this SimpleNumberFormatter.
SimpleNumberFormatter()=default
Creates a shell, initialized but non-functional SimpleNumberFormatter.
static SimpleNumberFormatter forLocale(const icu::Locale &locale, UErrorCode &status)
Creates a new SimpleNumberFormatter with all locale defaults.
static SimpleNumberFormatter forLocaleAndSymbolsAndGroupingStrategy(const icu::Locale &locale, const DecimalFormatSymbols &symbols, UNumberGroupingStrategy groupingStrategy, UErrorCode &status)
Creates a new SimpleNumberFormatter, overriding the grouping strategy and symbols.
An input type for SimpleNumberFormatter.
void setSign(USimpleNumberSign sign, UErrorCode &status)
Sets the sign of the number: an explicit plus sign, explicit minus sign, or no sign.
SimpleNumber & operator=(SimpleNumber &&other) noexcept
SimpleNumber move assignment.
SimpleNumber(SimpleNumber &&other) noexcept
SimpleNumber move constructor.
void setMinimumIntegerDigits(uint32_t minimumIntegerDigits, UErrorCode &status)
Pads the beginning of the number with zeros up to the given minimum number of integer digits.
void setMinimumFractionDigits(uint32_t minimumFractionDigits, UErrorCode &status)
Pads the end of the number with zeros up to the given minimum number of fraction digits.
void truncateStart(uint32_t maximumIntegerDigits, UErrorCode &status)
Truncates the most significant digits to the given maximum number of integer digits.
~SimpleNumber()
Destruct this SimpleNumber, cleaning up any memory it might own.
void multiplyByPowerOfTen(int32_t power, UErrorCode &status)
Changes the value of the SimpleNumber by a power of 10.
SimpleNumber()=default
Creates a new, empty SimpleNumber that does not contain a value.
static SimpleNumber forInt64(int64_t value, UErrorCode &status)
Creates a SimpleNumber for an integer.
void roundTo(int32_t power, UNumberFormatRoundingMode roundingMode, UErrorCode &status)
Rounds the value currently stored in the SimpleNumber to the given power of 10.
C++ API: Symbols for formatting numbers.
C API: Formatted number result from various number formatting functions.
UNumberFormatRoundingMode
The possible number format rounding modes.
UNumberGroupingStrategy
An enum declaring the strategy for when and how to display grouping separators (i....
@ UNUM_GROUPING_AUTO
Display grouping using the default strategy for all locales.
C API: Simple number formatting focused on low memory and code size.
USimpleNumberSign
An explicit sign option for a SimpleNumber.
@ UNUM_SIMPLE_NUMBER_NO_SIGN
Render no sign.
Basic definitions for ICU, for both C and C++ APIs.
UErrorCode
Standard ICU4C error code type, a substitute for exceptions.
Definition: utypes.h:415
#define U_I18N_API
Set to export library symbols from inside the i18n library, and to import them from outside.
Definition: utypes.h:301