measfmt.h

Go to the documentation of this file.

// © 2016 and later: Unicode, Inc. and others.
// License & terms of use: http://www.unicode.org/copyright.html
/*
**********************************************************************
* Copyright (c) 2004-2016, International Business Machines
* Corporation and others.  All Rights Reserved.
**********************************************************************
* Author: Alan Liu
* Created: April 20, 2004
* Since: ICU 3.0
**********************************************************************
*/
#ifndef MEASUREFORMAT_H
#define MEASUREFORMAT_H
 
#include "unicode/utypes.h"
 
#if !UCONFIG_NO_FORMATTING
 
#include "unicode/format.h"
#include "unicode/udat.h"
 
enum UMeasureFormatWidth {
 
    // Wide, short, and narrow must be first and in this order.
    UMEASFMT_WIDTH_WIDE,
 
    UMEASFMT_WIDTH_SHORT,
 
    UMEASFMT_WIDTH_NARROW,
 
    UMEASFMT_WIDTH_NUMERIC,
 
#ifndef U_HIDE_DEPRECATED_API
 
    UMEASFMT_WIDTH_COUNT = 4
#endif  // U_HIDE_DEPRECATED_API
};
typedef enum UMeasureFormatWidth UMeasureFormatWidth; 
 
U_NAMESPACE_BEGIN
 
class Measure;
class MeasureUnit;
class NumberFormat;
class PluralRules;
class MeasureFormatCacheData;
class SharedNumberFormat;
class SharedPluralRules;
class QuantityFormatter;
class SimpleFormatter;
class ListFormatter;
class DateFormat;
 
class U_I18N_API MeasureFormat : public Format {
 public:
    using Format::parseObject;
    using Format::format;
 
    MeasureFormat(
            const Locale &locale, UMeasureFormatWidth width, UErrorCode &status);
 
    MeasureFormat(
            const Locale &locale,
            UMeasureFormatWidth width,
            NumberFormat *nfToAdopt,
            UErrorCode &status);
 
    MeasureFormat(const MeasureFormat &other);
 
    MeasureFormat &operator=(const MeasureFormat &rhs);
 
    virtual ~MeasureFormat();
 
    virtual UBool operator==(const Format &other) const;
 
    virtual Format *clone() const;
 
    virtual UnicodeString &format(
            const Formattable &obj,
            UnicodeString &appendTo,
            FieldPosition &pos,
            UErrorCode &status) const;
 
    virtual void parseObject(
            const UnicodeString &source,
            Formattable &reslt,
            ParsePosition &pos) const;
 
    UnicodeString &formatMeasures(
            const Measure *measures,
            int32_t measureCount,
            UnicodeString &appendTo,
            FieldPosition &pos,
            UErrorCode &status) const;
 
    UnicodeString &formatMeasurePerUnit(
            const Measure &measure,
            const MeasureUnit &perUnit,
            UnicodeString &appendTo,
            FieldPosition &pos,
            UErrorCode &status) const;
 
    UnicodeString getUnitDisplayName(const MeasureUnit& unit, UErrorCode &status) const;
 
 
    static MeasureFormat* U_EXPORT2 createCurrencyFormat(const Locale& locale,
                                               UErrorCode& ec);
 
    static MeasureFormat* U_EXPORT2 createCurrencyFormat(UErrorCode& ec);
 
    static UClassID U_EXPORT2 getStaticClassID(void);
 
    virtual UClassID getDynamicClassID(void) const;
 
 protected:
    MeasureFormat();
 
#ifndef U_HIDE_INTERNAL_API 
 
    void initMeasureFormat(
            const Locale &locale,
            UMeasureFormatWidth width,
            NumberFormat *nfToAdopt,
            UErrorCode &status);
    UBool setMeasureFormatLocale(const Locale &locale, UErrorCode &status);
 
    void adoptNumberFormat(NumberFormat *nfToAdopt, UErrorCode &status);
 
    const NumberFormat &getNumberFormat() const;
 
    const PluralRules &getPluralRules() const;
 
    Locale getLocale(UErrorCode &status) const;
 
    const char *getLocaleID(UErrorCode &status) const;
 
#endif /* U_HIDE_INTERNAL_API */
 
 private:
    const MeasureFormatCacheData *cache;
    const SharedNumberFormat *numberFormat;
    const SharedPluralRules *pluralRules;
    UMeasureFormatWidth fWidth;    
 
    // Declared outside of MeasureFormatSharedData because ListFormatter
    // objects are relatively cheap to copy; therefore, they don't need to be
    // shared across instances.
    ListFormatter *listFormatter;
 
    const SimpleFormatter *getFormatterOrNull(
            const MeasureUnit &unit, UMeasureFormatWidth width, int32_t index) const;
 
    const SimpleFormatter *getFormatter(
            const MeasureUnit &unit, UMeasureFormatWidth width, int32_t index,
            UErrorCode &errorCode) const;
 
    const SimpleFormatter *getPluralFormatter(
            const MeasureUnit &unit, UMeasureFormatWidth width, int32_t index,
            UErrorCode &errorCode) const;
 
    const SimpleFormatter *getPerFormatter(
            UMeasureFormatWidth width,
            UErrorCode &status) const;
 
    int32_t withPerUnitAndAppend(
        const UnicodeString &formatted,
        const MeasureUnit &perUnit,
        UnicodeString &appendTo,
        UErrorCode &status) const;
 
    UnicodeString &formatMeasure(
        const Measure &measure,
        const NumberFormat &nf,
        UnicodeString &appendTo,
        FieldPosition &pos,
        UErrorCode &status) const;
 
    UnicodeString &formatMeasuresSlowTrack(
        const Measure *measures,
        int32_t measureCount,
        UnicodeString& appendTo,
        FieldPosition& pos,
        UErrorCode& status) const;
 
    UnicodeString &formatNumeric(
        const Formattable *hms,  // always length 3: [0] is hour; [1] is
                                 // minute; [2] is second.
        int32_t bitMap,   // 1=hour set, 2=minute set, 4=second set
        UnicodeString &appendTo,
        UErrorCode &status) const;
 
    UnicodeString &formatNumeric(
        UDate date,
        const DateFormat &dateFmt,
        UDateFormatField smallestField,
        const Formattable &smallestAmount,
        UnicodeString &appendTo,
        UErrorCode &status) const;
};
 
U_NAMESPACE_END
 
#endif // #if !UCONFIG_NO_FORMATTING
#endif // #ifndef MEASUREFORMAT_H