numberformatter.h

Go to the documentation of this file.

// © 2017 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html

#include "unicode/utypes.h"

#if !UCONFIG_NO_FORMATTING
#ifndef __NUMBERFORMATTER_H__
#define __NUMBERFORMATTER_H__

#include "unicode/appendable.h"
#include "unicode/dcfmtsym.h"
#include "unicode/currunit.h"
#include "unicode/fieldpos.h"
#include "unicode/fpositer.h"
#include "unicode/measunit.h"
#include "unicode/nounit.h"
#include "unicode/plurrule.h"
#include "unicode/ucurr.h"
#include "unicode/unum.h"
#include "unicode/unumberformatter.h"
#include "unicode/uobject.h"

#ifndef U_HIDE_DRAFT_API

U_NAMESPACE_BEGIN

// Forward declarations:
class IFixedDecimal;
class FieldPositionIteratorHandler;

namespace numparse {
namespace impl {

// Forward declarations:
class NumberParserImpl;
class MultiplierParseHandler;

}
}

namespace number {  // icu::number

// Forward declarations:
class UnlocalizedNumberFormatter;
class LocalizedNumberFormatter;
class FormattedNumber;
class Notation;
class ScientificNotation;
class Precision;
class FractionPrecision;
class CurrencyPrecision;
class IncrementPrecision;
class IntegerWidth;

namespace impl {

typedef int16_t digits_t;

static constexpr int32_t DEFAULT_THRESHOLD = 3;

// Forward declarations:
class Padder;
struct MacroProps;
struct MicroProps;
class DecimalQuantity;
struct UFormattedNumberData;
class NumberFormatterImpl;
struct ParsedPatternInfo;
class ScientificModifier;
class MultiplierProducer;
class RoundingImpl;
class ScientificHandler;
class Modifier;
class NumberStringBuilder;
class AffixPatternProvider;
class NumberPropertyMapper;
struct DecimalFormatProperties;
class MultiplierFormatHandler;
class CurrencySymbols;
class GeneratorHelpers;
class DecNum;
class NumberRangeFormatterImpl;
struct RangeMacroProps;

void touchRangeLocales(impl::RangeMacroProps& macros);

} // namespace impl

typedef Notation CompactNotation;

typedef Notation SimpleNotation;

class U_I18N_API Notation : public UMemory {
  public:
    static ScientificNotation scientific();

    static ScientificNotation engineering();

    static CompactNotation compactShort();

    static CompactNotation compactLong();

    static SimpleNotation simple();

  private:
    enum NotationType {
        NTN_SCIENTIFIC, NTN_COMPACT, NTN_SIMPLE, NTN_ERROR
    } fType;

    union NotationUnion {
        // For NTN_SCIENTIFIC
        struct ScientificSettings {
            int8_t fEngineeringInterval;
            bool fRequireMinInt;
            impl::digits_t fMinExponentDigits;
            UNumberSignDisplay fExponentSignDisplay;
        } scientific;

        // For NTN_COMPACT
        UNumberCompactStyle compactStyle;

        // For NTN_ERROR
        UErrorCode errorCode;
    } fUnion;

    typedef NotationUnion::ScientificSettings ScientificSettings;

    Notation(const NotationType &type, const NotationUnion &union_) : fType(type), fUnion(union_) {}

    Notation(UErrorCode errorCode) : fType(NTN_ERROR) {
        fUnion.errorCode = errorCode;
    }

    Notation() : fType(NTN_SIMPLE), fUnion() {}

    UBool copyErrorTo(UErrorCode &status) const {
        if (fType == NTN_ERROR) {
            status = fUnion.errorCode;
            return TRUE;
        }
        return FALSE;
    }

    // To allow MacroProps to initialize empty instances:
    friend struct impl::MacroProps;
    friend class ScientificNotation;

    // To allow implementation to access internal types:
    friend class impl::NumberFormatterImpl;
    friend class impl::ScientificModifier;
    friend class impl::ScientificHandler;

    // To allow access to the skeleton generation code:
    friend class impl::GeneratorHelpers;
};

class U_I18N_API ScientificNotation : public Notation {
  public:
    ScientificNotation withMinExponentDigits(int32_t minExponentDigits) const;

    ScientificNotation withExponentSignDisplay(UNumberSignDisplay exponentSignDisplay) const;

  private:
    // Inherit constructor
    using Notation::Notation;

    // Raw constructor for NumberPropertyMapper
    ScientificNotation(int8_t fEngineeringInterval, bool fRequireMinInt, impl::digits_t fMinExponentDigits,
                       UNumberSignDisplay fExponentSignDisplay);

    friend class Notation;

    // So that NumberPropertyMapper can create instances
    friend class impl::NumberPropertyMapper;
};

typedef Precision SignificantDigitsPrecision;

// Typedefs for ICU 60/61 compatibility.
// These will be removed in ICU 64.
// See http://bugs.icu-project.org/trac/ticket/13746

typedef Precision Rounder;

typedef FractionPrecision FractionRounder;

typedef IncrementPrecision IncrementRounder;

typedef CurrencyPrecision CurrencyRounder;

class U_I18N_API Precision : public UMemory {

  public:
    static Precision unlimited();

    static FractionPrecision integer();

    static FractionPrecision fixedFraction(int32_t minMaxFractionPlaces);

    static FractionPrecision minFraction(int32_t minFractionPlaces);

    static FractionPrecision maxFraction(int32_t maxFractionPlaces);

    static FractionPrecision minMaxFraction(int32_t minFractionPlaces, int32_t maxFractionPlaces);

    static SignificantDigitsPrecision fixedSignificantDigits(int32_t minMaxSignificantDigits);

    static SignificantDigitsPrecision minSignificantDigits(int32_t minSignificantDigits);

    static SignificantDigitsPrecision maxSignificantDigits(int32_t maxSignificantDigits);

    static SignificantDigitsPrecision minMaxSignificantDigits(int32_t minSignificantDigits,
                                                              int32_t maxSignificantDigits);

#ifndef U_HIDE_DEPRECATED_API
    // Compatiblity methods that will be removed in ICU 64.
    // See http://bugs.icu-project.org/trac/ticket/13746

    static inline SignificantDigitsPrecision fixedDigits(int32_t a) {
        return fixedSignificantDigits(a);
    }

    static inline SignificantDigitsPrecision minDigits(int32_t a) {
        return minSignificantDigits(a);
    }

    static inline SignificantDigitsPrecision maxDigits(int32_t a) {
        return maxSignificantDigits(a);
    }

    static inline SignificantDigitsPrecision minMaxDigits(int32_t a, int32_t b) {
        return minMaxSignificantDigits(a, b);
    }
#endif  /* U_HIDE_DEPRECATED_API */

    static IncrementPrecision increment(double roundingIncrement);

    static CurrencyPrecision currency(UCurrencyUsage currencyUsage);

#ifndef U_HIDE_DEPRECATED_API

    Precision withMode(UNumberFormatRoundingMode roundingMode) const;
#endif  /* U_HIDE_DEPRECATED_API */

  private:
    enum PrecisionType {
        RND_BOGUS,
        RND_NONE,
        RND_FRACTION,
        RND_SIGNIFICANT,
        RND_FRACTION_SIGNIFICANT,
        RND_INCREMENT,
        RND_CURRENCY,
        RND_ERROR
    } fType;

    union PrecisionUnion {
        struct FractionSignificantSettings {
            // For RND_FRACTION, RND_SIGNIFICANT, and RND_FRACTION_SIGNIFICANT
            impl::digits_t fMinFrac;
            impl::digits_t fMaxFrac;
            impl::digits_t fMinSig;
            impl::digits_t fMaxSig;
        } fracSig;
        struct IncrementSettings {
            double fIncrement;
            impl::digits_t fMinFrac;
            impl::digits_t fMaxFrac;
        } increment; // For RND_INCREMENT
        UCurrencyUsage currencyUsage; // For RND_CURRENCY
        UErrorCode errorCode; // For RND_ERROR
    } fUnion;

    typedef PrecisionUnion::FractionSignificantSettings FractionSignificantSettings;
    typedef PrecisionUnion::IncrementSettings IncrementSettings;

    UNumberFormatRoundingMode fRoundingMode;

    Precision(const PrecisionType& type, const PrecisionUnion& union_,
              UNumberFormatRoundingMode roundingMode)
            : fType(type), fUnion(union_), fRoundingMode(roundingMode) {}

    Precision(UErrorCode errorCode) : fType(RND_ERROR) {
        fUnion.errorCode = errorCode;
    }

    Precision() : fType(RND_BOGUS) {}

    bool isBogus() const {
        return fType == RND_BOGUS;
    }

    UBool copyErrorTo(UErrorCode &status) const {
        if (fType == RND_ERROR) {
            status = fUnion.errorCode;
            return TRUE;
        }
        return FALSE;
    }

    // On the parent type so that this method can be called internally on Precision instances.
    Precision withCurrency(const CurrencyUnit &currency, UErrorCode &status) const;

    static FractionPrecision constructFraction(int32_t minFrac, int32_t maxFrac);

    static Precision constructSignificant(int32_t minSig, int32_t maxSig);

    static Precision
    constructFractionSignificant(const FractionPrecision &base, int32_t minSig, int32_t maxSig);

    static IncrementPrecision constructIncrement(double increment, int32_t minFrac);

    static CurrencyPrecision constructCurrency(UCurrencyUsage usage);

    static Precision constructPassThrough();

    // To allow MacroProps/MicroProps to initialize bogus instances:
    friend struct impl::MacroProps;
    friend struct impl::MicroProps;

    // To allow NumberFormatterImpl to access isBogus() and other internal methods:
    friend class impl::NumberFormatterImpl;

    // To allow NumberPropertyMapper to create instances from DecimalFormatProperties:
    friend class impl::NumberPropertyMapper;

    // To allow access to the main implementation class:
    friend class impl::RoundingImpl;

    // To allow child classes to call private methods:
    friend class FractionPrecision;
    friend class CurrencyPrecision;
    friend class IncrementPrecision;

    // To allow access to the skeleton generation code:
    friend class impl::GeneratorHelpers;
};

class U_I18N_API FractionPrecision : public Precision {
  public:
    Precision withMinDigits(int32_t minSignificantDigits) const;

    Precision withMaxDigits(int32_t maxSignificantDigits) const;

  private:
    // Inherit constructor
    using Precision::Precision;

    // To allow parent class to call this class's constructor:
    friend class Precision;
};

class U_I18N_API CurrencyPrecision : public Precision {
  public:
    Precision withCurrency(const CurrencyUnit &currency) const;

  private:
    // Inherit constructor
    using Precision::Precision;

    // To allow parent class to call this class's constructor:
    friend class Precision;
};

class U_I18N_API IncrementPrecision : public Precision {
  public:
    Precision withMinFraction(int32_t minFrac) const;

  private:
    // Inherit constructor
    using Precision::Precision;

    // To allow parent class to call this class's constructor:
    friend class Precision;
};

class U_I18N_API IntegerWidth : public UMemory {
  public:
    static IntegerWidth zeroFillTo(int32_t minInt);

    IntegerWidth truncateAt(int32_t maxInt);

  private:
    union {
        struct {
            impl::digits_t fMinInt;
            impl::digits_t fMaxInt;
            bool fFormatFailIfMoreThanMaxDigits;
        } minMaxInt;
        UErrorCode errorCode;
    } fUnion;
    bool fHasError = false;

    IntegerWidth(impl::digits_t minInt, impl::digits_t maxInt, bool formatFailIfMoreThanMaxDigits);

    IntegerWidth(UErrorCode errorCode) { // NOLINT
        fUnion.errorCode = errorCode;
        fHasError = true;
    }

    IntegerWidth() { // NOLINT
        fUnion.minMaxInt.fMinInt = -1;
    }

    static IntegerWidth standard() {
        return IntegerWidth::zeroFillTo(1);
    }

    bool isBogus() const {
        return !fHasError && fUnion.minMaxInt.fMinInt == -1;
    }

    UBool copyErrorTo(UErrorCode &status) const {
        if (fHasError) {
            status = fUnion.errorCode;
            return TRUE;
        }
        return FALSE;
    }

    void apply(impl::DecimalQuantity &quantity, UErrorCode &status) const;

    bool operator==(const IntegerWidth& other) const;

    // To allow MacroProps/MicroProps to initialize empty instances:
    friend struct impl::MacroProps;
    friend struct impl::MicroProps;

    // To allow NumberFormatterImpl to access isBogus() and perform other operations:
    friend class impl::NumberFormatterImpl;

    // So that NumberPropertyMapper can create instances
    friend class impl::NumberPropertyMapper;

    // To allow access to the skeleton generation code:
    friend class impl::GeneratorHelpers;
};

class U_I18N_API Scale : public UMemory {
  public:
    static Scale none();

    static Scale powerOfTen(int32_t power);

    static Scale byDecimal(StringPiece multiplicand);

    static Scale byDouble(double multiplicand);

    static Scale byDoubleAndPowerOfTen(double multiplicand, int32_t power);

    // We need a custom destructor for the DecNum, which means we need to declare
    // the copy/move constructor/assignment quartet.

    Scale(const Scale& other);

    Scale& operator=(const Scale& other);

    Scale(Scale&& src) U_NOEXCEPT;

    Scale& operator=(Scale&& src) U_NOEXCEPT;

    ~Scale();

#ifndef U_HIDE_INTERNAL_API

    Scale(int32_t magnitude, impl::DecNum* arbitraryToAdopt);
#endif  /* U_HIDE_INTERNAL_API */

  private:
    int32_t fMagnitude;
    impl::DecNum* fArbitrary;
    UErrorCode fError;

    Scale(UErrorCode error) : fMagnitude(0), fArbitrary(nullptr), fError(error) {}

    Scale() : fMagnitude(0), fArbitrary(nullptr), fError(U_ZERO_ERROR) {}

    bool isValid() const {
        return fMagnitude != 0 || fArbitrary != nullptr;
    }

    UBool copyErrorTo(UErrorCode &status) const {
        if (fError != U_ZERO_ERROR) {
            status = fError;
            return TRUE;
        }
        return FALSE;
    }

    void applyTo(impl::DecimalQuantity& quantity) const;

    void applyReciprocalTo(impl::DecimalQuantity& quantity) const;

    // To allow MacroProps/MicroProps to initialize empty instances:
    friend struct impl::MacroProps;
    friend struct impl::MicroProps;

    // To allow NumberFormatterImpl to access isBogus() and perform other operations:
    friend class impl::NumberFormatterImpl;

    // To allow the helper class MultiplierFormatHandler access to private fields:
    friend class impl::MultiplierFormatHandler;

    // To allow access to the skeleton generation code:
    friend class impl::GeneratorHelpers;

    // To allow access to parsing code:
    friend class ::icu::numparse::impl::NumberParserImpl;
    friend class ::icu::numparse::impl::MultiplierParseHandler;
};

namespace impl {

// Do not enclose entire SymbolsWrapper with #ifndef U_HIDE_INTERNAL_API, needed for a protected field
class U_I18N_API SymbolsWrapper : public UMemory {
  public:
    SymbolsWrapper() : fType(SYMPTR_NONE), fPtr{nullptr} {}

    SymbolsWrapper(const SymbolsWrapper &other);

    SymbolsWrapper &operator=(const SymbolsWrapper &other);

    SymbolsWrapper(SymbolsWrapper&& src) U_NOEXCEPT;

    SymbolsWrapper &operator=(SymbolsWrapper&& src) U_NOEXCEPT;

    ~SymbolsWrapper();

#ifndef U_HIDE_INTERNAL_API

    void setTo(const DecimalFormatSymbols &dfs);

    void setTo(const NumberingSystem *ns);

    bool isDecimalFormatSymbols() const;

    bool isNumberingSystem() const;

    const DecimalFormatSymbols *getDecimalFormatSymbols() const;

    const NumberingSystem *getNumberingSystem() const;

#endif  // U_HIDE_INTERNAL_API

    UBool copyErrorTo(UErrorCode &status) const {
        if (fType == SYMPTR_DFS && fPtr.dfs == nullptr) {
            status = U_MEMORY_ALLOCATION_ERROR;
            return TRUE;
        } else if (fType == SYMPTR_NS && fPtr.ns == nullptr) {
            status = U_MEMORY_ALLOCATION_ERROR;
            return TRUE;
        }
        return FALSE;
    }

  private:
    enum SymbolsPointerType {
        SYMPTR_NONE, SYMPTR_DFS, SYMPTR_NS
    } fType;

    union {
        const DecimalFormatSymbols *dfs;
        const NumberingSystem *ns;
    } fPtr;

    void doCopyFrom(const SymbolsWrapper &other);

    void doMoveFrom(SymbolsWrapper&& src);

    void doCleanup();
};

// Do not enclose entire Grouper with #ifndef U_HIDE_INTERNAL_API, needed for a protected field
class U_I18N_API Grouper : public UMemory {
  public:
#ifndef U_HIDE_INTERNAL_API

    static Grouper forStrategy(UNumberGroupingStrategy grouping);

    static Grouper forProperties(const DecimalFormatProperties& properties);

    // Future: static Grouper forProperties(DecimalFormatProperties& properties);

    Grouper(int16_t grouping1, int16_t grouping2, int16_t minGrouping, UNumberGroupingStrategy strategy)
            : fGrouping1(grouping1),
              fGrouping2(grouping2),
              fMinGrouping(minGrouping),
              fStrategy(strategy) {}
#endif  // U_HIDE_INTERNAL_API

    int16_t getPrimary() const;

    int16_t getSecondary() const;

  private:
    int16_t fGrouping1;
    int16_t fGrouping2;

    int16_t fMinGrouping;

    UNumberGroupingStrategy fStrategy;

    Grouper() : fGrouping1(-3) {};

    bool isBogus() const {
        return fGrouping1 == -3;
    }

    void setLocaleData(const impl::ParsedPatternInfo &patternInfo, const Locale& locale);

    bool groupAtPosition(int32_t position, const impl::DecimalQuantity &value) const;

    // To allow MacroProps/MicroProps to initialize empty instances:
    friend struct MacroProps;
    friend struct MicroProps;

    // To allow NumberFormatterImpl to access isBogus() and perform other operations:
    friend class NumberFormatterImpl;

    // To allow NumberParserImpl to perform setLocaleData():
    friend class ::icu::numparse::impl::NumberParserImpl;

    // To allow access to the skeleton generation code:
    friend class impl::GeneratorHelpers;
};

// Do not enclose entire Padder with #ifndef U_HIDE_INTERNAL_API, needed for a protected field
class U_I18N_API Padder : public UMemory {
  public:
#ifndef U_HIDE_INTERNAL_API

    static Padder none();

    static Padder codePoints(UChar32 cp, int32_t targetWidth, UNumberFormatPadPosition position);
#endif  // U_HIDE_INTERNAL_API

    static Padder forProperties(const DecimalFormatProperties& properties);

  private:
    UChar32 fWidth;  // -3 = error; -2 = bogus; -1 = no padding
    union {
        struct {
            int32_t fCp;
            UNumberFormatPadPosition fPosition;
        } padding;
        UErrorCode errorCode;
    } fUnion;

    Padder(UChar32 cp, int32_t width, UNumberFormatPadPosition position);

    Padder(int32_t width);

    Padder(UErrorCode errorCode) : fWidth(-3) { // NOLINT
        fUnion.errorCode = errorCode;
    }

    Padder() : fWidth(-2) {} // NOLINT

    bool isBogus() const {
        return fWidth == -2;
    }

    UBool copyErrorTo(UErrorCode &status) const {
        if (fWidth == -3) {
            status = fUnion.errorCode;
            return TRUE;
        }
        return FALSE;
    }

    bool isValid() const {
        return fWidth > 0;
    }

    int32_t padAndApply(const impl::Modifier &mod1, const impl::Modifier &mod2,
                        impl::NumberStringBuilder &string, int32_t leftIndex, int32_t rightIndex,
                        UErrorCode &status) const;

    // To allow MacroProps/MicroProps to initialize empty instances:
    friend struct MacroProps;
    friend struct MicroProps;

    // To allow NumberFormatterImpl to access isBogus() and perform other operations:
    friend class impl::NumberFormatterImpl;

    // To allow access to the skeleton generation code:
    friend class impl::GeneratorHelpers;
};

// Do not enclose entire MacroProps with #ifndef U_HIDE_INTERNAL_API, needed for a protected field
struct U_I18N_API MacroProps : public UMemory {
    Notation notation;

    MeasureUnit unit; // = NoUnit::base();

    MeasureUnit perUnit; // = NoUnit::base();

    Precision precision;  // = Precision();  (bogus)

    UNumberFormatRoundingMode roundingMode = UNUM_ROUND_HALFEVEN;

    Grouper grouper;  // = Grouper();  (bogus)

    Padder padder;    // = Padder();   (bogus)

    IntegerWidth integerWidth; // = IntegerWidth(); (bogus)

    SymbolsWrapper symbols;

    // UNUM_XYZ_COUNT denotes null (bogus) values.

    UNumberUnitWidth unitWidth = UNUM_UNIT_WIDTH_COUNT;

    UNumberSignDisplay sign = UNUM_SIGN_COUNT;

    UNumberDecimalSeparatorDisplay decimal = UNUM_DECIMAL_SEPARATOR_COUNT;

    Scale scale;  // = Scale();  (benign value)

    const AffixPatternProvider* affixProvider = nullptr;  // no ownership

    const PluralRules* rules = nullptr;  // no ownership

    const CurrencySymbols* currencySymbols = nullptr;  // no ownership

    int32_t threshold = DEFAULT_THRESHOLD;

    Locale locale;

    // NOTE: Uses default copy and move constructors.

    bool copyErrorTo(UErrorCode &status) const {
        return notation.copyErrorTo(status) || precision.copyErrorTo(status) ||
               padder.copyErrorTo(status) || integerWidth.copyErrorTo(status) ||
               symbols.copyErrorTo(status) || scale.copyErrorTo(status);
    }
};

} // namespace impl

template<typename Derived>
class U_I18N_API NumberFormatterSettings {
  public:
    Derived notation(const Notation &notation) const &;

    Derived notation(const Notation &notation) &&;

    Derived unit(const icu::MeasureUnit &unit) const &;

    Derived unit(const icu::MeasureUnit &unit) &&;

    Derived adoptUnit(icu::MeasureUnit *unit) const &;

    Derived adoptUnit(icu::MeasureUnit *unit) &&;

    Derived perUnit(const icu::MeasureUnit &perUnit) const &;

    Derived perUnit(const icu::MeasureUnit &perUnit) &&;

    Derived adoptPerUnit(icu::MeasureUnit *perUnit) const &;

    Derived adoptPerUnit(icu::MeasureUnit *perUnit) &&;

    Derived precision(const Precision& precision) const &;

    Derived precision(const Precision& precision) &&;

#ifndef U_HIDE_DEPRECATED_API
    // Compatibility method that will be removed in ICU 64.
    // Use precision() instead.
    // See http://bugs.icu-project.org/trac/ticket/13746
    Derived rounding(const Rounder& rounder) const & {
        return precision(rounder);
    }
#endif  /* U_HIDE_DEPRECATED_API */

    Derived roundingMode(UNumberFormatRoundingMode roundingMode) const &;

    Derived roundingMode(UNumberFormatRoundingMode roundingMode) &&;

    Derived grouping(UNumberGroupingStrategy strategy) const &;

    Derived grouping(UNumberGroupingStrategy strategy) &&;

    Derived integerWidth(const IntegerWidth &style) const &;

    Derived integerWidth(const IntegerWidth &style) &&;

    Derived symbols(const DecimalFormatSymbols &symbols) const &;

    Derived symbols(const DecimalFormatSymbols &symbols) &&;

    Derived adoptSymbols(NumberingSystem *symbols) const &;

    Derived adoptSymbols(NumberingSystem *symbols) &&;

    Derived unitWidth(UNumberUnitWidth width) const &;

    Derived unitWidth(UNumberUnitWidth width) &&;

    Derived sign(UNumberSignDisplay style) const &;

    Derived sign(UNumberSignDisplay style) &&;

    Derived decimal(UNumberDecimalSeparatorDisplay style) const &;

    Derived decimal(UNumberDecimalSeparatorDisplay style) &&;

    Derived scale(const Scale &scale) const &;

    Derived scale(const Scale &scale) &&;

#ifndef U_HIDE_INTERNAL_API

    Derived padding(const impl::Padder &padder) const &;

    Derived padding(const impl::Padder &padder) &&;

    Derived threshold(int32_t threshold) const &;

    Derived threshold(int32_t threshold) &&;

    Derived macros(const impl::MacroProps& macros) const &;

    Derived macros(const impl::MacroProps& macros) &&;

    Derived macros(impl::MacroProps&& macros) const &;

    Derived macros(impl::MacroProps&& macros) &&;

#endif  /* U_HIDE_INTERNAL_API */

    UnicodeString toSkeleton(UErrorCode& status) const;

    UBool copyErrorTo(UErrorCode &outErrorCode) const {
        if (U_FAILURE(outErrorCode)) {
            // Do not overwrite the older error code
            return TRUE;
        }
        fMacros.copyErrorTo(outErrorCode);
        return U_FAILURE(outErrorCode);
    };

    // NOTE: Uses default copy and move constructors.

  private:
    impl::MacroProps fMacros;

    // Don't construct me directly!  Use (Un)LocalizedNumberFormatter.
    NumberFormatterSettings() = default;

    friend class LocalizedNumberFormatter;
    friend class UnlocalizedNumberFormatter;

    // Give NumberRangeFormatter access to the MacroProps
    friend void impl::touchRangeLocales(impl::RangeMacroProps& macros);
    friend class impl::NumberRangeFormatterImpl;
};

class U_I18N_API UnlocalizedNumberFormatter
        : public NumberFormatterSettings<UnlocalizedNumberFormatter>, public UMemory {

  public:
    LocalizedNumberFormatter locale(const icu::Locale &locale) const &;

    LocalizedNumberFormatter locale(const icu::Locale &locale) &&;

    UnlocalizedNumberFormatter() = default;

    UnlocalizedNumberFormatter(const UnlocalizedNumberFormatter &other);

    UnlocalizedNumberFormatter(UnlocalizedNumberFormatter&& src) U_NOEXCEPT;

    UnlocalizedNumberFormatter& operator=(const UnlocalizedNumberFormatter& other);

    UnlocalizedNumberFormatter& operator=(UnlocalizedNumberFormatter&& src) U_NOEXCEPT;

  private:
    explicit UnlocalizedNumberFormatter(const NumberFormatterSettings<UnlocalizedNumberFormatter>& other);

    explicit UnlocalizedNumberFormatter(
            NumberFormatterSettings<UnlocalizedNumberFormatter>&& src) U_NOEXCEPT;

    // To give the fluent setters access to this class's constructor:
    friend class NumberFormatterSettings<UnlocalizedNumberFormatter>;

    // To give NumberFormatter::with() access to this class's constructor:
    friend class NumberFormatter;
};

class U_I18N_API LocalizedNumberFormatter
        : public NumberFormatterSettings<LocalizedNumberFormatter>, public UMemory {
  public:
    FormattedNumber formatInt(int64_t value, UErrorCode &status) const;

    FormattedNumber formatDouble(double value, UErrorCode &status) const;

    FormattedNumber formatDecimal(StringPiece value, UErrorCode& status) const;

#ifndef U_HIDE_INTERNAL_API

    FormattedNumber formatDecimalQuantity(const impl::DecimalQuantity& dq, UErrorCode& status) const;

    void getAffixImpl(bool isPrefix, bool isNegative, UnicodeString& result, UErrorCode& status) const;

    const impl::NumberFormatterImpl* getCompiled() const;

    int32_t getCallCount() const;

#endif  /* U_HIDE_INTERNAL_API */

    Format* toFormat(UErrorCode& status) const;

    LocalizedNumberFormatter() = default;

    LocalizedNumberFormatter(const LocalizedNumberFormatter &other);

    LocalizedNumberFormatter(LocalizedNumberFormatter&& src) U_NOEXCEPT;

    LocalizedNumberFormatter& operator=(const LocalizedNumberFormatter& other);

    LocalizedNumberFormatter& operator=(LocalizedNumberFormatter&& src) U_NOEXCEPT;

#ifndef U_HIDE_INTERNAL_API

    void formatImpl(impl::UFormattedNumberData *results, UErrorCode &status) const;

#endif  /* U_HIDE_INTERNAL_API */

    ~LocalizedNumberFormatter();

  private:
    // Note: fCompiled can't be a LocalPointer because impl::NumberFormatterImpl is defined in an internal
    // header, and LocalPointer needs the full class definition in order to delete the instance.
    const impl::NumberFormatterImpl* fCompiled {nullptr};
    char fUnsafeCallCount[8] {};  // internally cast to u_atomic_int32_t

    explicit LocalizedNumberFormatter(const NumberFormatterSettings<LocalizedNumberFormatter>& other);

    explicit LocalizedNumberFormatter(NumberFormatterSettings<LocalizedNumberFormatter>&& src) U_NOEXCEPT;

    LocalizedNumberFormatter(const impl::MacroProps &macros, const Locale &locale);

    LocalizedNumberFormatter(impl::MacroProps &&macros, const Locale &locale);

    void clear();

    void lnfMoveHelper(LocalizedNumberFormatter&& src);

    bool computeCompiled(UErrorCode& status) const;

    // To give the fluent setters access to this class's constructor:
    friend class NumberFormatterSettings<UnlocalizedNumberFormatter>;
    friend class NumberFormatterSettings<LocalizedNumberFormatter>;

    // To give UnlocalizedNumberFormatter::locale() access to this class's constructor:
    friend class UnlocalizedNumberFormatter;
};

class U_I18N_API FormattedNumber : public UMemory {
  public:
#ifndef U_HIDE_DEPRECATED_API

    UnicodeString toString() const;
#endif  /* U_HIDE_DEPRECATED_API */

    UnicodeString toString(UErrorCode& status) const;

#ifndef U_HIDE_DEPRECATED_API

    Appendable &appendTo(Appendable &appendable);
#endif  /* U_HIDE_DEPRECATED_API */

    Appendable &appendTo(Appendable &appendable, UErrorCode& status) const;

#ifndef U_HIDE_DEPRECATED_API

    void populateFieldPosition(FieldPosition &fieldPosition, UErrorCode &status);
#endif  /* U_HIDE_DEPRECATED_API */

    UBool nextFieldPosition(FieldPosition& fieldPosition, UErrorCode& status) const;

#ifndef U_HIDE_DEPRECATED_API

    void populateFieldPositionIterator(FieldPositionIterator &iterator, UErrorCode &status);
#endif  /* U_HIDE_DEPRECATED_API */

    void getAllFieldPositions(FieldPositionIterator &iterator, UErrorCode &status) const;

#ifndef U_HIDE_INTERNAL_API

    void getDecimalQuantity(impl::DecimalQuantity& output, UErrorCode& status) const;

    void getAllFieldPositionsImpl(FieldPositionIteratorHandler& fpih, UErrorCode& status) const;

#endif  /* U_HIDE_INTERNAL_API */

    FormattedNumber(const FormattedNumber&) = delete;

    FormattedNumber& operator=(const FormattedNumber&) = delete;

    FormattedNumber(FormattedNumber&& src) U_NOEXCEPT;

    FormattedNumber& operator=(FormattedNumber&& src) U_NOEXCEPT;

    ~FormattedNumber();

  private:
    // Can't use LocalPointer because UFormattedNumberData is forward-declared
    const impl::UFormattedNumberData *fResults;

    // Error code for the terminal methods
    UErrorCode fErrorCode;

    explicit FormattedNumber(impl::UFormattedNumberData *results)
        : fResults(results), fErrorCode(U_ZERO_ERROR) {};

    explicit FormattedNumber(UErrorCode errorCode)
        : fResults(nullptr), fErrorCode(errorCode) {};

    // To give LocalizedNumberFormatter format methods access to this class's constructor:
    friend class LocalizedNumberFormatter;
};

class U_I18N_API NumberFormatter final {
  public:
    static UnlocalizedNumberFormatter with();

    static LocalizedNumberFormatter withLocale(const Locale &locale);

    static UnlocalizedNumberFormatter forSkeleton(const UnicodeString& skeleton, UErrorCode& status);

    NumberFormatter() = delete;
};

}  // namespace number
U_NAMESPACE_END

#endif  // U_HIDE_DRAFT_API

#endif // __NUMBERFORMATTER_H__

#endif /* #if !UCONFIG_NO_FORMATTING */

---