ICU 62.1 62.1
Public Member Functions | Static Public Member Functions | Friends
icu::number::Scale Class Reference

A class that defines a quantity by which a number should be multiplied when formatting. More...

#include <numberformatter.h>

Inheritance diagram for icu::number::Scale:
icu::UMemory

Public Member Functions

 Scale (const Scale &other)
 
Scaleoperator= (const Scale &other)
 
 Scale (Scale &&src)
 
Scaleoperator= (Scale &&src)
 
 ~Scale ()
 
 Scale (int32_t magnitude, impl::DecNum *arbitraryToAdopt)
 

Static Public Member Functions

static Scale none ()
 Do not change the value of numbers when formatting or parsing.
 
static Scale powerOfTen (int32_t power)
 Multiply numbers by a power of ten before formatting.
 
static Scale byDecimal (StringPiece multiplicand)
 Multiply numbers by an arbitrary value before formatting.
 
static Scale byDouble (double multiplicand)
 Multiply numbers by an arbitrary value before formatting.
 
static Scale byDoubleAndPowerOfTen (double multiplicand, int32_t power)
 Multiply a number by both a power of ten and by an arbitrary double value.
 

Friends

struct impl::MacroProps
 
struct impl::MicroProps
 
class impl::NumberFormatterImpl
 
class impl::MultiplierFormatHandler
 
class impl::GeneratorHelpers
 
class ::icu::numparse::impl::NumberParserImpl
 
class ::icu::numparse::impl::MultiplierParseHandler
 

Detailed Description

A class that defines a quantity by which a number should be multiplied when formatting.

To create a Scale, use one of the factory methods.

Draft
This API may be changed in the future versions and was introduced in ICU 62

Definition at line 989 of file numberformatter.h.

Constructor & Destructor Documentation

◆ Scale() [1/3]

icu::number::Scale::Scale ( const Scale & other)
Draft
This API may be changed in the future versions and was introduced in ICU 62

◆ Scale() [2/3]

icu::number::Scale::Scale ( Scale && src)
Draft
This API may be changed in the future versions and was introduced in ICU 62

◆ ~Scale()

icu::number::Scale::~Scale ( )
Draft
This API may be changed in the future versions and was introduced in ICU 62

◆ Scale() [3/3]

icu::number::Scale::Scale ( int32_t magnitude,
impl::DecNum * arbitraryToAdopt )
Internal
Do not use. This API is for internal use only.

Member Function Documentation

◆ byDecimal()

static Scale icu::number::Scale::byDecimal ( StringPiece multiplicand)
static

Multiply numbers by an arbitrary value before formatting.

Useful for unit conversions.

This method takes a string in a decimal number format with syntax as defined in the Decimal Arithmetic Specification, available at http://speleotrove.com/decimal

Also see the version of this method that takes a double.

Returns
A Scale for passing to the setter in NumberFormatter.
Draft
This API may be changed in the future versions and was introduced in ICU 62

◆ byDouble()

static Scale icu::number::Scale::byDouble ( double multiplicand)
static

Multiply numbers by an arbitrary value before formatting.

Useful for unit conversions.

This method takes a double; also see the version of this method that takes an exact decimal.

Returns
A Scale for passing to the setter in NumberFormatter.
Draft
This API may be changed in the future versions and was introduced in ICU 62

◆ byDoubleAndPowerOfTen()

static Scale icu::number::Scale::byDoubleAndPowerOfTen ( double multiplicand,
int32_t power )
static

Multiply a number by both a power of ten and by an arbitrary double value.

Returns
A Scale for passing to the setter in NumberFormatter.
Draft
This API may be changed in the future versions and was introduced in ICU 62

◆ none()

static Scale icu::number::Scale::none ( )
static

Do not change the value of numbers when formatting or parsing.

Returns
A Scale to prevent any multiplication.
Draft
This API may be changed in the future versions and was introduced in ICU 62

◆ operator=() [1/2]

Scale & icu::number::Scale::operator= ( const Scale & other)
Draft
This API may be changed in the future versions and was introduced in ICU 62

◆ operator=() [2/2]

Scale & icu::number::Scale::operator= ( Scale && src)
Draft
This API may be changed in the future versions and was introduced in ICU 62

◆ powerOfTen()

static Scale icu::number::Scale::powerOfTen ( int32_t power)
static

Multiply numbers by a power of ten before formatting.

Useful for combining with a percent unit:

NumberFormatter::with().unit(NoUnit::percent()).multiplier(Scale::powerOfTen(2))
Returns
A Scale for passing to the setter in NumberFormatter.
Draft
This API may be changed in the future versions and was introduced in ICU 62

Friends And Related Symbol Documentation

◆ ::icu::numparse::impl::MultiplierParseHandler

friend class ::icu::numparse::impl::MultiplierParseHandler
friend

Definition at line 1106 of file numberformatter.h.

◆ ::icu::numparse::impl::NumberParserImpl

friend class ::icu::numparse::impl::NumberParserImpl
friend

Definition at line 1105 of file numberformatter.h.

◆ impl::GeneratorHelpers

friend class impl::GeneratorHelpers
friend

Definition at line 1102 of file numberformatter.h.

◆ impl::MacroProps

Definition at line 1092 of file numberformatter.h.

◆ impl::MicroProps

friend struct impl::MicroProps
friend

Definition at line 1093 of file numberformatter.h.

◆ impl::MultiplierFormatHandler

friend class impl::MultiplierFormatHandler
friend

Definition at line 1099 of file numberformatter.h.

◆ impl::NumberFormatterImpl

friend class impl::NumberFormatterImpl
friend

Definition at line 1096 of file numberformatter.h.


The documentation for this class was generated from the following file: