Coverage Report

Created: 2025-06-24 06:43

/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 */