Coverage Report

Created: 2018-09-25 14:53

/src/mozilla-central/intl/icu/source/i18n/number_patternstring.h
Line
Count
Source (jump to first uncovered line)
1
// © 2017 and later: Unicode, Inc. and others.
2
// License & terms of use: http://www.unicode.org/copyright.html
3
4
#include "unicode/utypes.h"
5
6
#if !UCONFIG_NO_FORMATTING
7
#ifndef __NUMBER_PATTERNSTRING_H__
8
#define __NUMBER_PATTERNSTRING_H__
9
10
11
#include <cstdint>
12
#include "unicode/unum.h"
13
#include "unicode/unistr.h"
14
#include "number_types.h"
15
#include "number_decimalquantity.h"
16
#include "number_decimfmtprops.h"
17
#include "number_affixutils.h"
18
19
U_NAMESPACE_BEGIN namespace number {
20
namespace impl {
21
22
// Forward declaration
23
class PatternParser;
24
25
// Exported as U_I18N_API because it is a public member field of exported ParsedSubpatternInfo
26
struct U_I18N_API Endpoints {
27
    int32_t start = 0;
28
    int32_t end = 0;
29
};
30
31
// Exported as U_I18N_API because it is a public member field of exported ParsedPatternInfo
32
struct U_I18N_API ParsedSubpatternInfo {
33
    uint64_t groupingSizes = 0x0000ffffffff0000L;
34
    int32_t integerLeadingHashSigns = 0;
35
    int32_t integerTrailingHashSigns = 0;
36
    int32_t integerNumerals = 0;
37
    int32_t integerAtSigns = 0;
38
    int32_t integerTotal = 0; // for convenience
39
    int32_t fractionNumerals = 0;
40
    int32_t fractionHashSigns = 0;
41
    int32_t fractionTotal = 0; // for convenience
42
    bool hasDecimal = false;
43
    int32_t widthExceptAffixes = 0;
44
    // Note: NullableValue causes issues here with std::move.
45
    bool hasPadding = false;
46
    UNumberFormatPadPosition paddingLocation = UNUM_PAD_BEFORE_PREFIX;
47
    DecimalQuantity rounding;
48
    bool exponentHasPlusSign = false;
49
    int32_t exponentZeros = 0;
50
    bool hasPercentSign = false;
51
    bool hasPerMilleSign = false;
52
    bool hasCurrencySign = false;
53
    bool hasMinusSign = false;
54
    bool hasPlusSign = false;
55
56
    Endpoints prefixEndpoints;
57
    Endpoints suffixEndpoints;
58
    Endpoints paddingEndpoints;
59
};
60
61
// Exported as U_I18N_API because it is needed for the unit test PatternStringTest
62
struct U_I18N_API ParsedPatternInfo : public AffixPatternProvider, public UMemory {
63
    UnicodeString pattern;
64
    ParsedSubpatternInfo positive;
65
    ParsedSubpatternInfo negative;
66
67
    ParsedPatternInfo()
68
0
            : state(this->pattern), currentSubpattern(nullptr) {}
69
70
0
    ~ParsedPatternInfo() U_OVERRIDE = default;
71
72
    // Need to declare this explicitly because of the destructor
73
    ParsedPatternInfo& operator=(ParsedPatternInfo&& src) U_NOEXCEPT = default;
74
75
    static int32_t getLengthFromEndpoints(const Endpoints& endpoints);
76
77
    char16_t charAt(int32_t flags, int32_t index) const U_OVERRIDE;
78
79
    int32_t length(int32_t flags) const U_OVERRIDE;
80
81
    UnicodeString getString(int32_t flags) const U_OVERRIDE;
82
83
    bool positiveHasPlusSign() const U_OVERRIDE;
84
85
    bool hasNegativeSubpattern() const U_OVERRIDE;
86
87
    bool negativeHasMinusSign() const U_OVERRIDE;
88
89
    bool hasCurrencySign() const U_OVERRIDE;
90
91
    bool containsSymbolType(AffixPatternType type, UErrorCode& status) const U_OVERRIDE;
92
93
    bool hasBody() const U_OVERRIDE;
94
95
  private:
96
    struct U_I18N_API ParserState {
97
        const UnicodeString& pattern; // reference to the parent
98
        int32_t offset = 0;
99
100
        explicit ParserState(const UnicodeString& _pattern)
101
0
                : pattern(_pattern) {};
102
103
0
        ParserState& operator=(ParserState&& src) U_NOEXCEPT {
104
0
            // Leave pattern reference alone; it will continue to point to the same place in memory,
105
0
            // which gets overwritten by ParsedPatternInfo's implicit move assignment.
106
0
            offset = src.offset;
107
0
            return *this;
108
0
        }
109
110
        UChar32 peek();
111
112
        UChar32 next();
113
114
        // TODO: We don't currently do anything with the message string.
115
        // This method is here as a shell for Java compatibility.
116
0
        inline void toParseException(const char16_t* message) { (void) message; }
117
    } state;
118
119
    // NOTE: In Java, these are written as pure functions.
120
    // In C++, they're written as methods.
121
    // The behavior is the same.
122
123
    // Mutable transient pointer:
124
    ParsedSubpatternInfo* currentSubpattern;
125
126
    // In Java, "negative == null" tells us whether or not we had a negative subpattern.
127
    // In C++, we need to remember in another boolean.
128
    bool fHasNegativeSubpattern = false;
129
130
    const Endpoints& getEndpoints(int32_t flags) const;
131
132
    /** Run the recursive descent parser. */
133
    void consumePattern(const UnicodeString& patternString, UErrorCode& status);
134
135
    void consumeSubpattern(UErrorCode& status);
136
137
    void consumePadding(PadPosition paddingLocation, UErrorCode& status);
138
139
    void consumeAffix(Endpoints& endpoints, UErrorCode& status);
140
141
    void consumeLiteral(UErrorCode& status);
142
143
    void consumeFormat(UErrorCode& status);
144
145
    void consumeIntegerFormat(UErrorCode& status);
146
147
    void consumeFractionFormat(UErrorCode& status);
148
149
    void consumeExponent(UErrorCode& status);
150
151
    friend class PatternParser;
152
};
153
154
enum IgnoreRounding {
155
    IGNORE_ROUNDING_NEVER = 0, IGNORE_ROUNDING_IF_CURRENCY = 1, IGNORE_ROUNDING_ALWAYS = 2
156
};
157
158
class U_I18N_API PatternParser {
159
  public:
160
    /**
161
     * Runs the recursive descent parser on the given pattern string, returning a data structure with raw information
162
     * about the pattern string.
163
     *
164
     * <p>
165
     * To obtain a more useful form of the data, consider using {@link #parseToProperties} instead.
166
     *
167
     * TODO: Change argument type to const char16_t* instead of UnicodeString?
168
     *
169
     * @param patternString
170
     *            The LDML decimal format pattern (Excel-style pattern) to parse.
171
     * @return The results of the parse.
172
     */
173
    static void parseToPatternInfo(const UnicodeString& patternString, ParsedPatternInfo& patternInfo,
174
                                   UErrorCode& status);
175
176
    /**
177
     * Parses a pattern string into a new property bag.
178
     *
179
     * @param pattern
180
     *            The pattern string, like "#,##0.00"
181
     * @param ignoreRounding
182
     *            Whether to leave out rounding information (minFrac, maxFrac, and rounding increment) when parsing the
183
     *            pattern. This may be desirable if a custom rounding mode, such as CurrencyUsage, is to be used
184
     *            instead.
185
     * @return A property bag object.
186
     * @throws IllegalArgumentException
187
     *             If there is a syntax error in the pattern string.
188
     */
189
    static DecimalFormatProperties parseToProperties(const UnicodeString& pattern,
190
                                                     IgnoreRounding ignoreRounding, UErrorCode& status);
191
192
    static DecimalFormatProperties parseToProperties(const UnicodeString& pattern, UErrorCode& status);
193
194
    /**
195
     * Parses a pattern string into an existing property bag. All properties that can be encoded into a pattern string
196
     * will be overwritten with either their default value or with the value coming from the pattern string. Properties
197
     * that cannot be encoded into a pattern string, such as rounding mode, are not modified.
198
     *
199
     * @param pattern
200
     *            The pattern string, like "#,##0.00"
201
     * @param properties
202
     *            The property bag object to overwrite.
203
     * @param ignoreRounding
204
     *            See {@link #parseToProperties(String pattern, int ignoreRounding)}.
205
     * @throws IllegalArgumentException
206
     *             If there was a syntax error in the pattern string.
207
     */
208
    static void parseToExistingProperties(const UnicodeString& pattern,
209
                                          DecimalFormatProperties& properties,
210
                                          IgnoreRounding ignoreRounding, UErrorCode& status);
211
212
  private:
213
    static void parseToExistingPropertiesImpl(const UnicodeString& pattern,
214
                                              DecimalFormatProperties& properties,
215
                                              IgnoreRounding ignoreRounding, UErrorCode& status);
216
217
    /** Finalizes the temporary data stored in the ParsedPatternInfo to the Properties. */
218
    static void patternInfoToProperties(DecimalFormatProperties& properties,
219
                                        ParsedPatternInfo& patternInfo, IgnoreRounding _ignoreRounding,
220
                                        UErrorCode& status);
221
};
222
223
class U_I18N_API PatternStringUtils {
224
  public:
225
    /**
226
     * Creates a pattern string from a property bag.
227
     *
228
     * <p>
229
     * Since pattern strings support only a subset of the functionality available in a property bag, a new property bag
230
     * created from the string returned by this function may not be the same as the original property bag.
231
     *
232
     * @param properties
233
     *            The property bag to serialize.
234
     * @return A pattern string approximately serializing the property bag.
235
     */
236
    static UnicodeString propertiesToPatternString(const DecimalFormatProperties& properties,
237
                                                   UErrorCode& status);
238
239
240
    /**
241
     * Converts a pattern between standard notation and localized notation. Localized notation means that instead of
242
     * using generic placeholders in the pattern, you use the corresponding locale-specific characters instead. For
243
     * example, in locale <em>fr-FR</em>, the period in the pattern "0.000" means "decimal" in standard notation (as it
244
     * does in every other locale), but it means "grouping" in localized notation.
245
     *
246
     * <p>
247
     * A greedy string-substitution strategy is used to substitute locale symbols. If two symbols are ambiguous or have
248
     * the same prefix, the result is not well-defined.
249
     *
250
     * <p>
251
     * Locale symbols are not allowed to contain the ASCII quote character.
252
     *
253
     * <p>
254
     * This method is provided for backwards compatibility and should not be used in any new code.
255
     *
256
     * TODO(C++): This method is not yet implemented.
257
     *
258
     * @param input
259
     *            The pattern to convert.
260
     * @param symbols
261
     *            The symbols corresponding to the localized pattern.
262
     * @param toLocalized
263
     *            true to convert from standard to localized notation; false to convert from localized to standard
264
     *            notation.
265
     * @return The pattern expressed in the other notation.
266
     */
267
    static UnicodeString convertLocalized(const UnicodeString& input, const DecimalFormatSymbols& symbols,
268
                                          bool toLocalized, UErrorCode& status);
269
270
    /**
271
     * This method contains the heart of the logic for rendering LDML affix strings. It handles
272
     * sign-always-shown resolution, whether to use the positive or negative subpattern, permille
273
     * substitution, and plural forms for CurrencyPluralInfo.
274
     */
275
    static void patternInfoToStringBuilder(const AffixPatternProvider& patternInfo, bool isPrefix,
276
                                           int8_t signum, UNumberSignDisplay signDisplay,
277
                                           StandardPlural::Form plural, bool perMilleReplacesPercent,
278
                                           UnicodeString& output);
279
280
  private:
281
    /** @return The number of chars inserted. */
282
    static int escapePaddingString(UnicodeString input, UnicodeString& output, int startIndex,
283
                                   UErrorCode& status);
284
};
285
286
} // namespace impl
287
} // namespace number
288
U_NAMESPACE_END
289
290
291
#endif //__NUMBER_PATTERNSTRING_H__
292
293
#endif /* #if !UCONFIG_NO_FORMATTING */