2014-01-29 05:08:55 +00:00
|
|
|
/*
|
|
|
|
******************************************************************************
|
2015-12-02 22:54:54 +00:00
|
|
|
* Copyright (C) 2014-2015, International Business Machines
|
2014-01-29 05:08:55 +00:00
|
|
|
* Corporation and others. All Rights Reserved.
|
|
|
|
******************************************************************************
|
|
|
|
* quantityformatter.h
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef __QUANTITY_FORMATTER_H__
|
|
|
|
#define __QUANTITY_FORMATTER_H__
|
|
|
|
|
|
|
|
#include "unicode/utypes.h"
|
|
|
|
#include "unicode/uobject.h"
|
|
|
|
|
2014-09-13 00:53:06 +00:00
|
|
|
#if !UCONFIG_NO_FORMATTING
|
|
|
|
|
2015-12-14 21:57:41 +00:00
|
|
|
#include "standardplural.h"
|
2015-12-02 22:54:54 +00:00
|
|
|
|
2014-01-29 05:08:55 +00:00
|
|
|
U_NAMESPACE_BEGIN
|
|
|
|
|
2014-01-29 22:57:06 +00:00
|
|
|
class SimplePatternFormatter;
|
2014-01-29 05:08:55 +00:00
|
|
|
class UnicodeString;
|
|
|
|
class PluralRules;
|
|
|
|
class NumberFormat;
|
|
|
|
class Formattable;
|
2014-02-04 00:29:17 +00:00
|
|
|
class FieldPosition;
|
2014-01-29 05:08:55 +00:00
|
|
|
|
|
|
|
/**
|
2014-01-29 22:57:06 +00:00
|
|
|
* A plural aware formatter that is good for expressing a single quantity and
|
2014-01-29 05:08:55 +00:00
|
|
|
* a unit.
|
|
|
|
* <p>
|
|
|
|
* First use the add() methods to add a pattern for each plural variant.
|
|
|
|
* There must be a pattern for the "other" variant.
|
|
|
|
* Then use the format() method.
|
|
|
|
* <p>
|
|
|
|
* Concurrent calls only to const methods on a QuantityFormatter object are
|
|
|
|
* safe, but concurrent const and non-const method calls on a QuantityFormatter
|
|
|
|
* object are not safe and require synchronization.
|
|
|
|
*
|
|
|
|
*/
|
2014-01-29 05:52:11 +00:00
|
|
|
class U_I18N_API QuantityFormatter : public UMemory {
|
2014-01-29 05:08:55 +00:00
|
|
|
public:
|
|
|
|
/**
|
|
|
|
* Default constructor.
|
|
|
|
*/
|
|
|
|
QuantityFormatter();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Copy constructor.
|
|
|
|
*/
|
|
|
|
QuantityFormatter(const QuantityFormatter& other);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Assignment operator
|
|
|
|
*/
|
|
|
|
QuantityFormatter &operator=(const QuantityFormatter& other);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Destructor.
|
|
|
|
*/
|
|
|
|
~QuantityFormatter();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Removes all variants from this object including the "other" variant.
|
|
|
|
*/
|
|
|
|
void reset();
|
|
|
|
|
|
|
|
/**
|
2015-12-02 22:54:54 +00:00
|
|
|
* Adds a plural variant if there is none yet for the plural form.
|
|
|
|
*
|
|
|
|
* @param variant "zero", "one", "two", "few", "many", "other"
|
|
|
|
* @param rawPattern the pattern for the variant e.g "{0} meters"
|
|
|
|
* @param status any error returned here.
|
|
|
|
* @return TRUE on success; FALSE if status was set to a non zero error.
|
|
|
|
*/
|
2015-12-16 04:41:33 +00:00
|
|
|
UBool addIfAbsent(const char *variant, const UnicodeString &rawPattern, UErrorCode &status);
|
2014-01-29 05:08:55 +00:00
|
|
|
|
2014-02-04 00:29:17 +00:00
|
|
|
/**
|
|
|
|
* returns TRUE if this object has at least the "other" variant.
|
|
|
|
*/
|
|
|
|
UBool isValid() const;
|
|
|
|
|
2014-09-10 20:06:52 +00:00
|
|
|
/**
|
|
|
|
* Gets the pattern formatter that would be used for a particular variant.
|
|
|
|
* If isValid() returns TRUE, this method is guaranteed to return a
|
|
|
|
* non-NULL value.
|
|
|
|
*/
|
|
|
|
const SimplePatternFormatter *getByVariant(const char *variant) const;
|
|
|
|
|
2014-01-29 05:08:55 +00:00
|
|
|
/**
|
2015-12-16 04:41:33 +00:00
|
|
|
* Formats a number with this object appending the result to appendTo.
|
2014-01-29 05:08:55 +00:00
|
|
|
* At least the "other" variant must be added to this object for this
|
|
|
|
* method to work.
|
|
|
|
*
|
2015-12-16 04:41:33 +00:00
|
|
|
* @param number the single number.
|
|
|
|
* @param fmt formats the number
|
2014-01-29 05:08:55 +00:00
|
|
|
* @param rules computes the plural variant to use.
|
|
|
|
* @param appendTo result appended here.
|
|
|
|
* @param status any error returned here.
|
|
|
|
* @return appendTo
|
|
|
|
*/
|
|
|
|
UnicodeString &format(
|
2015-12-16 04:41:33 +00:00
|
|
|
const Formattable &number,
|
2014-01-29 05:08:55 +00:00
|
|
|
const NumberFormat &fmt,
|
|
|
|
const PluralRules &rules,
|
|
|
|
UnicodeString &appendTo,
|
2014-02-04 00:29:17 +00:00
|
|
|
FieldPosition &pos,
|
2014-01-29 05:08:55 +00:00
|
|
|
UErrorCode &status) const;
|
|
|
|
|
2015-12-16 04:41:33 +00:00
|
|
|
/**
|
|
|
|
* Selects the standard plural form for the number/formatter/rules.
|
|
|
|
*/
|
|
|
|
static StandardPlural::Form selectPlural(
|
|
|
|
const Formattable &number,
|
|
|
|
const NumberFormat &fmt,
|
|
|
|
const PluralRules &rules,
|
|
|
|
UnicodeString &formattedNumber,
|
|
|
|
FieldPosition &pos,
|
2015-12-02 22:54:54 +00:00
|
|
|
UErrorCode &status);
|
|
|
|
|
2015-12-16 04:41:33 +00:00
|
|
|
/**
|
|
|
|
* Formats the pattern with the value and adjusts the FieldPosition.
|
|
|
|
*/
|
|
|
|
static UnicodeString &format(
|
|
|
|
const SimplePatternFormatter &pattern,
|
|
|
|
const UnicodeString &value,
|
|
|
|
UnicodeString &appendTo,
|
|
|
|
FieldPosition &pos,
|
|
|
|
UErrorCode &status);
|
|
|
|
|
|
|
|
private:
|
2015-12-14 21:57:41 +00:00
|
|
|
SimplePatternFormatter *formatters[StandardPlural::COUNT];
|
2014-01-29 05:08:55 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
U_NAMESPACE_END
|
|
|
|
|
|
|
|
#endif
|
2014-09-13 00:53:06 +00:00
|
|
|
|
|
|
|
#endif
|