A result from searching within a string.
A Match or an Iterable of Match objects is returned from Pattern matching methods.
The following example finds all matches of a RegExp in a String and iterates through the returned iterable of Match objects.
RegExp exp = new RegExp(r"(\w+)");
String str = "Parse my string";
Iterable<Match> matches = exp.allMatches(str);
for (Match m in matches) {
String match = m.group(0);
print(match);
}
The output of the example is:
Parse
my
string
Some patterns, regular expressions in particular, may record subtrings that were part of the matching. These are called groups in the Match object. Some patterns may never have any groups, and their matches always have zero groupCount.
Properties
- int end
-
read-onlyReturns the index in the string after the last character of the match.
- int groupCount
-
read-onlyReturns the number of captured groups in the match.
- String input
-
read-onlyThe string on which this match was computed.
- Pattern pattern
-
read-onlyThe pattern used to search in
input
. - int start
-
read-onlyReturns the index in the string where the match starts.
Constructors
- Match()
Operators
-
operator [](
int group) → String -
Returns the string matched by the given
group
.