| // © 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 __NUMBER_FORMATIMPL_H__ |
| #define __NUMBER_FORMATIMPL_H__ |
| |
| #include "number_types.h" |
| #include "number_stringbuilder.h" |
| #include "number_patternstring.h" |
| #include "number_utils.h" |
| #include "number_patternmodifier.h" |
| #include "number_longnames.h" |
| #include "number_compact.h" |
| #include "number_microprops.h" |
| |
| U_NAMESPACE_BEGIN namespace number { |
| namespace impl { |
| |
| /** |
| * This is the "brain" of the number formatting pipeline. It ties all the pieces together, taking in a MacroProps and a |
| * DecimalQuantity and outputting a properly formatted number string. |
| */ |
| class NumberFormatterImpl : public UMemory { |
| public: |
| /** |
| * Builds a "safe" MicroPropsGenerator, which is thread-safe and can be used repeatedly. |
| * The caller owns the returned NumberFormatterImpl. |
| */ |
| static NumberFormatterImpl *fromMacros(const MacroProps ¯os, UErrorCode &status); |
| |
| /** |
| * Builds and evaluates an "unsafe" MicroPropsGenerator, which is cheaper but can be used only once. |
| */ |
| static void |
| applyStatic(const MacroProps ¯os, DecimalQuantity &inValue, NumberStringBuilder &outString, |
| UErrorCode &status); |
| |
| /** |
| * Prints only the prefix and suffix; used for DecimalFormat getters. |
| * |
| * @return The index into the output at which the prefix ends and the suffix starts; in other words, |
| * the prefix length. |
| */ |
| static int32_t getPrefixSuffixStatic(const MacroProps& macros, int8_t signum, |
| StandardPlural::Form plural, NumberStringBuilder& outString, |
| UErrorCode& status); |
| |
| /** |
| * Evaluates the "safe" MicroPropsGenerator created by "fromMacros". |
| */ |
| void apply(DecimalQuantity& inValue, NumberStringBuilder& outString, UErrorCode& status) const; |
| |
| /** |
| * Like getPrefixSuffixStatic() but uses the safe compiled object. |
| */ |
| int32_t getPrefixSuffix(int8_t signum, StandardPlural::Form plural, NumberStringBuilder& outString, |
| UErrorCode& status) const; |
| |
| private: |
| // Head of the MicroPropsGenerator linked list: |
| const MicroPropsGenerator *fMicroPropsGenerator = nullptr; |
| |
| // Tail of the list: |
| MicroProps fMicros; |
| |
| // Other fields possibly used by the number formatting pipeline: |
| // TODO: Convert more of these LocalPointers to value objects to reduce the number of news? |
| LocalPointer<const DecimalFormatSymbols> fSymbols; |
| LocalPointer<const PluralRules> fRules; |
| LocalPointer<const ParsedPatternInfo> fPatternInfo; |
| LocalPointer<const ScientificHandler> fScientificHandler; |
| LocalPointer<MutablePatternModifier> fPatternModifier; |
| LocalPointer<const ImmutablePatternModifier> fImmutablePatternModifier; |
| LocalPointer<const LongNameHandler> fLongNameHandler; |
| LocalPointer<const CompactHandler> fCompactHandler; |
| |
| // Value objects possibly used by the number formatting pipeline: |
| struct Warehouse { |
| CurrencySymbols fCurrencySymbols; |
| } fWarehouse; |
| |
| |
| NumberFormatterImpl(const MacroProps ¯os, bool safe, UErrorCode &status); |
| |
| void applyUnsafe(DecimalQuantity &inValue, NumberStringBuilder &outString, UErrorCode &status); |
| |
| int32_t getPrefixSuffixUnsafe(int8_t signum, StandardPlural::Form plural, |
| NumberStringBuilder& outString, UErrorCode& status); |
| |
| /** |
| * If rulesPtr is non-null, return it. Otherwise, return a PluralRules owned by this object for the |
| * specified locale, creating it if necessary. |
| */ |
| const PluralRules * |
| resolvePluralRules(const PluralRules *rulesPtr, const Locale &locale, UErrorCode &status); |
| |
| /** |
| * Synthesizes the MacroProps into a MicroPropsGenerator. All information, including the locale, is encoded into the |
| * MicroPropsGenerator, except for the quantity itself, which is left abstract and must be provided to the returned |
| * MicroPropsGenerator instance. |
| * |
| * @see MicroPropsGenerator |
| * @param macros |
| * The {@link MacroProps} to consume. This method does not mutate the MacroProps instance. |
| * @param safe |
| * If true, the returned MicroPropsGenerator will be thread-safe. If false, the returned value will |
| * <em>not</em> be thread-safe, intended for a single "one-shot" use only. Building the thread-safe |
| * object is more expensive. |
| */ |
| const MicroPropsGenerator * |
| macrosToMicroGenerator(const MacroProps ¯os, bool safe, UErrorCode &status); |
| |
| /** |
| * Synthesizes the output string from a MicroProps and DecimalQuantity. |
| * |
| * @param micros |
| * The MicroProps after the quantity has been consumed. Will not be mutated. |
| * @param quantity |
| * The DecimalQuantity to be rendered. May be mutated. |
| * @param string |
| * The output string. Will be mutated. |
| */ |
| static int32_t |
| microsToString(const MicroProps µs, DecimalQuantity &quantity, NumberStringBuilder &string, |
| UErrorCode &status); |
| |
| static int32_t |
| writeNumber(const MicroProps µs, DecimalQuantity &quantity, NumberStringBuilder &string, |
| UErrorCode &status); |
| |
| static int32_t |
| writeIntegerDigits(const MicroProps µs, DecimalQuantity &quantity, NumberStringBuilder &string, |
| UErrorCode &status); |
| |
| static int32_t |
| writeFractionDigits(const MicroProps µs, DecimalQuantity &quantity, NumberStringBuilder &string, |
| UErrorCode &status); |
| }; |
| |
| } // namespace impl |
| } // namespace number |
| U_NAMESPACE_END |
| |
| |
| #endif //__NUMBER_FORMATIMPL_H__ |
| |
| #endif /* #if !UCONFIG_NO_FORMATTING */ |