java.util.regex
介面 MatchResult

所有已知實作類別：

Matcher

public interface MatchResult

比對操作的結果。

此介面包含用於確定與正則表達式比對結果的查詢方法。通過 MatchResult 可以查看比對邊界、組和組邊界，但是不能修改。

從以下版本開始：

1.5

另請參見：

Matcher

方法摘要

int	end() 返回最後比對字元之後的偏移量。
int	end(int group) 返回在比對期間由給定組所捕獲子序列的最後字元之後的偏移量。
String	group() 返回由以前比對所比對的輸入子序列。
String	group(int group) 返回在以前比對操作期間由給定組捕獲的輸入子序列。
int	groupCount() 返回此比對結果的網要中的捕獲組數。
int	start() 返回比對的初始索引。
int	start(int group) 返回在比對期間由給定組捕獲的子序列的初始索引。

方法詳細資訊

start

int start()

返回比對的初始索引。

返回：

第一個比對字元的索引

拋出：

IllegalStateException - 如果沒有嘗試任何比對或者以前的比對操作失敗

start

int start(int group)

返回在比對期間由給定組捕獲的子序列的初始索引。

捕獲組是從左到右的索引，從 1 開始。組零表示整個網要，因此表達式 m.start(0) 等效於 m.start()。

參數：

group - 此比對器網要中捕獲組的索引

返回：

組捕獲的第一個字元的索引；如果比對成功但組本身沒有比對項，則返回 -1

拋出：

IllegalStateException - 如果沒有嘗試任何比對或者以前的比對操作失敗

IndexOutOfBoundsException - 如果在給定索引的網要中不存在捕獲組

end

int end()

返回最後比對字元之後的偏移量。

返回：

最後比對字元之後的偏移量

拋出：

IllegalStateException - 如果沒有嘗試任何比對或者以前的比對操作失敗

end

int end(int group)

返回在比對期間由給定組所捕獲子序列的最後字元之後的偏移量。

捕獲組是從左到右的索引，從 1 開始。組零表示整個網要，因此表達式 m.end(0) 等效於 m.end()。

參數：

group - 此比對器網要中捕獲組的索引

返回：

組捕獲的最後字元之後的偏移量；如果比對成功但組本身沒有比對項，則返回 -1

拋出：

IllegalStateException - 如果沒有嘗試任何比對或者以前的比對操作失敗

IndexOutOfBoundsException - 如果在給定索引的網要中不存在捕獲組

group

String group()

返回由以前比對所比對的輸入子序列。

對於具有輸入序列 s 的比對器 m，表達式 m.group() 和 s.substring(m.start(), m.end()) 是等效的。

注意，某些網要（例如，a*）比對空字元串。當網要成功比對輸入中的空字元串時，此方法將返回空字元串。

返回：

以前比對所比對的字元串形式的子序列（可能為空）

拋出：

IllegalStateException - 如果沒有嘗試任何比對或者以前的比對操作失敗

group

String group(int group)

返回在以前比對操作期間由給定組捕獲的輸入子序列。

對於比對器 m、輸入序列 s 和組索引 g，表達式 m.group(g) 和 s.substring(m.start(g), m.end(g)) 是等效的。

捕獲組是從左到右的索引，從 1 開始。組零表示整個網要，因此表達式 m.group(0) 等效於 m.group()。

如果該比對成功了，但指定組未能比對輸入序列的任何部分，則返回 null。注意，某些組（例如，(a*)）比對空字元串。當這種組成功比對輸入中的空字元串時，此方法將返回空字元串。

參數：

group - 此比對器網要中捕獲組的索引

返回：

在以前的比對期間組所捕獲的子序列（可能為空）；如果組未能比對輸入的部分，則返回 null

拋出：

IllegalStateException - 如果沒有嘗試任何比對或者以前的比對操作失敗

IndexOutOfBoundsException - 如果在給定索引的網要中不存在捕獲組

groupCount

int groupCount()

返回此比對結果的網要中的捕獲組數。

根據慣例，零組表示整個網要。它不包括在此計數中。

任何小於等於由此方法返回的值的非負整數保證是此比對器的有效組索引。

返回：

此比對器網要中的捕獲組數