formattednumber.h

Go to the documentation of this file.

// © 2022 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html
 
#ifndef __FORMATTEDNUMBER_H__
#define __FORMATTEDNUMBER_H__
 
#include "unicode/utypes.h"
 
#if U_SHOW_CPLUSPLUS_API
 
#if !UCONFIG_NO_FORMATTING
 
#include "unicode/uobject.h"
#include "unicode/formattedvalue.h"
#include "unicode/measunit.h"
#include "unicode/udisplayoptions.h"

 
U_NAMESPACE_BEGIN
 
class FieldPositionIteratorHandler;
class SimpleDateFormat;
 
namespace number {  // icu::number
 
namespace impl {
class DecimalQuantity;
class UFormattedNumberData;
struct UFormattedNumberImpl;
}  // icu::number::impl
 
 

class U_I18N_API FormattedNumber : public UMemory, public FormattedValue {
  public:

    FormattedNumber()
        : fData(nullptr), fErrorCode(U_INVALID_STATE_ERROR) {}

    FormattedNumber(FormattedNumber&& src) noexcept;

    virtual ~FormattedNumber() override;

    FormattedNumber(const FormattedNumber&) = delete;

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

    FormattedNumber& operator=(FormattedNumber&& src) noexcept;
 
    // Copybrief: this method is older than the parent method
    UnicodeString toString(UErrorCode& status) const override;
 
    // Copydoc: this method is new in ICU 64
    UnicodeString toTempString(UErrorCode& status) const override;
 
    // Copybrief: this method is older than the parent method
    Appendable &appendTo(Appendable& appendable, UErrorCode& status) const override;
 
    // Copydoc: this method is new in ICU 64
    UBool nextPosition(ConstrainedFieldPosition& cfpos, UErrorCode& status) const override;

    template<typename StringClass>
    inline StringClass toDecimalNumber(UErrorCode& status) const;

    MeasureUnit getOutputUnit(UErrorCode& status) const;

    UDisplayOptionsNounClass getNounClass(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 */
 
  private:
    // Can't use LocalPointer because UFormattedNumberData is forward-declared
    impl::UFormattedNumberData *fData;
 
    // Error code for the terminal methods
    UErrorCode fErrorCode;

    explicit FormattedNumber(impl::UFormattedNumberData *results)
        : fData(results), fErrorCode(U_ZERO_ERROR) {}
 
    explicit FormattedNumber(UErrorCode errorCode)
        : fData(nullptr), fErrorCode(errorCode) {}
 
    void toDecimalNumber(ByteSink& sink, UErrorCode& status) const;
 
    // To give LocalizedNumberFormatter format methods access to this class's constructor:
    friend class LocalizedNumberFormatter;
    friend class SimpleNumberFormatter;
 
    // To give C API access to internals
    friend struct impl::UFormattedNumberImpl;
 
    // To give access to the data pointer for non-heap allocation
    friend class icu::SimpleDateFormat;
};
 
template<typename StringClass>
StringClass FormattedNumber::toDecimalNumber(UErrorCode& status) const {
    StringClass result;
    StringByteSink<StringClass> sink(&result);
    toDecimalNumber(sink, status);
    return result;
}
 
}  // namespace number
U_NAMESPACE_END
 
#endif /* #if !UCONFIG_NO_FORMATTING */
 
#endif /* U_SHOW_CPLUSPLUS_API */
 
#endif // __FORMATTEDNUMBER_H__