/src/icu/source/i18n/numparse_compositions.h
Line  | Count  | Source (jump to first uncovered line)  | 
1  |  | // © 2018 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 __SOURCE_NUMPARSE_COMPOSITIONS__  | 
8  |  | #define __SOURCE_NUMPARSE_COMPOSITIONS__  | 
9  |  |  | 
10  |  | #include "numparse_types.h"  | 
11  |  |  | 
12  |  | U_NAMESPACE_BEGIN  | 
13  |  |  | 
14  |  | // Export an explicit template instantiation of the MaybeStackArray that is used as a data member of ArraySeriesMatcher.  | 
15  |  | // When building DLLs for Windows this is required even though no direct access to the MaybeStackArray leaks out of the i18n library.  | 
16  |  | // (See digitlst.h, pluralaffix.h, datefmt.h, and others for similar examples.)  | 
17  |  | #if U_PF_WINDOWS <= U_PLATFORM && U_PLATFORM <= U_PF_CYGWIN  | 
18  |  | template class U_I18N_API MaybeStackArray<const numparse::impl::NumberParseMatcher*, 3>;  | 
19  |  | #endif  | 
20  |  |  | 
21  |  | namespace numparse { | 
22  |  | namespace impl { | 
23  |  |  | 
24  |  | /**  | 
25  |  |  * Base class for AnyMatcher and SeriesMatcher.  | 
26  |  |  */  | 
27  |  | // Exported as U_I18N_API for tests  | 
28  |  | class U_I18N_API CompositionMatcher : public NumberParseMatcher { | 
29  |  |   protected:  | 
30  |  |     // No construction except by subclasses!  | 
31  | 0  |     CompositionMatcher() = default;  | 
32  |  |  | 
33  |  |     // To be overridden by subclasses (used for iteration):  | 
34  |  |     virtual const NumberParseMatcher* const* begin() const = 0;  | 
35  |  |  | 
36  |  |     // To be overridden by subclasses (used for iteration):  | 
37  |  |     virtual const NumberParseMatcher* const* end() const = 0;  | 
38  |  | };  | 
39  |  |  | 
40  |  |  | 
41  |  | // NOTE: AnyMatcher is no longer being used. The previous definition is shown below.  | 
42  |  | // The implementation can be found in SVN source control, deleted around March 30, 2018.  | 
43  |  | ///**  | 
44  |  | // * Composes a number of matchers, and succeeds if any of the matchers succeed. Always greedily chooses  | 
45  |  | // * the first matcher in the list to succeed.  | 
46  |  | // *  | 
47  |  | // * NOTE: In C++, this is a base class, unlike ICU4J, which uses a factory-style interface.  | 
48  |  | // *  | 
49  |  | // * @author sffc  | 
50  |  | // * @see SeriesMatcher  | 
51  |  | // */  | 
52  |  | //class AnyMatcher : public CompositionMatcher { | 
53  |  | //  public:  | 
54  |  | //    bool match(StringSegment& segment, ParsedNumber& result, UErrorCode& status) const override;  | 
55  |  | //  | 
56  |  | //    bool smokeTest(const StringSegment& segment) const override;  | 
57  |  | //  | 
58  |  | //    void postProcess(ParsedNumber& result) const override;  | 
59  |  | //  | 
60  |  | //  protected:  | 
61  |  | //    // No construction except by subclasses!  | 
62  |  | //    AnyMatcher() = default;  | 
63  |  | //};  | 
64  |  |  | 
65  |  |  | 
66  |  | /**  | 
67  |  |  * Composes a number of matchers, running one after another. Matches the input string only if all of the  | 
68  |  |  * matchers in the series succeed. Performs greedy matches within the context of the series.  | 
69  |  |  *  | 
70  |  |  * @author sffc  | 
71  |  |  * @see AnyMatcher  | 
72  |  |  */  | 
73  |  | // Exported as U_I18N_API for tests  | 
74  |  | class U_I18N_API SeriesMatcher : public CompositionMatcher { | 
75  |  |   public:  | 
76  |  |     bool match(StringSegment& segment, ParsedNumber& result, UErrorCode& status) const override;  | 
77  |  |  | 
78  |  |     bool smokeTest(const StringSegment& segment) const override;  | 
79  |  |  | 
80  |  |     void postProcess(ParsedNumber& result) const override;  | 
81  |  |  | 
82  |  |     virtual int32_t length() const = 0;  | 
83  |  |  | 
84  |  |   protected:  | 
85  |  |     // No construction except by subclasses!  | 
86  | 0  |     SeriesMatcher() = default;  | 
87  |  | };  | 
88  |  |  | 
89  |  | /**  | 
90  |  |  * An implementation of SeriesMatcher that references an array of matchers.  | 
91  |  |  *  | 
92  |  |  * The object adopts the array, but NOT the matchers contained inside the array.  | 
93  |  |  */  | 
94  |  | // Exported as U_I18N_API for tests  | 
95  |  | class U_I18N_API ArraySeriesMatcher : public SeriesMatcher { | 
96  |  |   public:  | 
97  |  |     ArraySeriesMatcher();  // WARNING: Leaves the object in an unusable state  | 
98  |  |  | 
99  |  |     typedef MaybeStackArray<const NumberParseMatcher*, 3> MatcherArray;  | 
100  |  |  | 
101  |  |     /** The array is std::move'd */  | 
102  |  |     ArraySeriesMatcher(MatcherArray& matchers, int32_t matchersLen);  | 
103  |  |  | 
104  |  |     UnicodeString toString() const override;  | 
105  |  |  | 
106  |  |     int32_t length() const override;  | 
107  |  |  | 
108  |  |   protected:  | 
109  |  |     const NumberParseMatcher* const* begin() const override;  | 
110  |  |  | 
111  |  |     const NumberParseMatcher* const* end() const override;  | 
112  |  |  | 
113  |  |   private:  | 
114  |  |     MatcherArray fMatchers;  | 
115  |  |     int32_t fMatchersLen;  | 
116  |  | };  | 
117  |  |  | 
118  |  |  | 
119  |  | } // namespace impl  | 
120  |  | } // namespace numparse  | 
121  |  | U_NAMESPACE_END  | 
122  |  |  | 
123  |  | #endif //__SOURCE_NUMPARSE_COMPOSITIONS__  | 
124  |  | #endif /* #if !UCONFIG_NO_FORMATTING */  |