Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public interface

MatchResult

java.util.regex.MatchResult
Known Indirect Subclasses

Class Overview

Holds the results of a successful match of a Pattern against a given string. Typically this is an instance of Matcher , but since that's a mutable class it's also possible to freeze its current state using toMatchResult() .

Summary

Public Methods
abstract int end ()
Returns the index of the first character following the text that matched the whole regular expression.
abstract int end (int group)
Returns the index of the first character following the text that matched a given group.
abstract String group ()
Returns the text that matched the whole regular expression.
abstract String group (int group)
Returns the text that matched a given group of the regular expression.
abstract int groupCount ()
Returns the number of groups in the results, which is always equal to the number of groups in the original regular expression.
abstract int start ()
Returns the index of the first character of the text that matched the whole regular expression.
abstract int start (int group)
Returns the index of the first character of the text that matched a given group.

Public Methods

public abstract int end ()

Added in API level 1

Returns the index of the first character following the text that matched the whole regular expression.

public abstract int end (int group)

Added in API level 1

Returns the index of the first character following the text that matched a given group. See group() for an explanation of group indexes.

public abstract String group ()

Added in API level 1

Returns the text that matched the whole regular expression.

public abstract String group (int group)

Added in API level 1

Returns the text that matched a given group of the regular expression.

Explicit capturing groups in the pattern are numbered left to right in order of their opening parenthesis, starting at 1. The special group 0 represents the entire match (as if the entire pattern is surrounded by an implicit capturing group). For example, "a((b)c)" matching "abc" would give the following groups:

          0 "abc"
 1 "bc"
 2 "b"
         

An optional capturing group that failed to match as part of an overall successful match (for example, "a(b)?c" matching "ac") returns null. A capturing group that matched the empty string (for example, "a(b?)c" matching "ac") returns the empty string.

public abstract int groupCount ()

Added in API level 1

Returns the number of groups in the results, which is always equal to the number of groups in the original regular expression.

public abstract int start ()

Added in API level 1

Returns the index of the first character of the text that matched the whole regular expression.

public abstract int start (int group)

Added in API level 1

Returns the index of the first character of the text that matched a given group. See group() for an explanation of group indexes.