当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
java.util.regex
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
MatchResult (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
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()
- 返回此匹配结果的模式中的捕获组数。
根据惯例，零组表示整个模式。它不包括在此计数中。
任何小于或等于由此方法返回的值的非负整数保证是此匹配器的有效组索引。
- 返回：
- 此匹配器模式中的捕获组数
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。