结构体
struct MatchData
public struct MatchData {}
功能:存储正则表达式匹配结果,并提供对正则匹配结果进行查询的函数。
func groupCount()
public func groupCount(): Int64
功能:获取捕获组的个数。
返回值:
- Int64 - 捕获组的个数。
func groupNumber() (deprecated)
public func groupNumber(): Int64
功能:获取捕获组的个数。
注意:
未来版本即将废弃,使用 groupCount() 替代。
返回值:
- Int64 - 捕获组的个数。
func matchPosition()
public func matchPosition(): Position
功能:获取上一次匹配到的子字符串在输入字符串中起始位置和末尾位置的索引。
返回值:
- Position - 匹配结果位置信息。
func matchPosition(Int64)
public func matchPosition(group: Int64): Position
功能:根据给定的索引获取上一次匹配中该捕获组匹配到的子字符串在输入字符串中的位置信息。
参数:
- group: Int64 - 指定组。
返回值:
- Position - 对应捕获组的位置信息。
异常:
- IllegalArgumentException - 当未开启捕获组提取,或 group 小于 0 或者大于 groupCount 时,抛出异常。
func matchPosition(String)
public func matchPosition(group: String): Position
功能:根据给定的命名捕获组名称取上一次匹配中该捕获组匹配到的子字符串在输入字符串中的位置信息。
参数:
- group: String - 指定命名捕获组的名称。
返回值:
- Position - 对应捕获组的位置信息。
异常:
- IllegalArgumentException - 当未开启捕获组提取,或 捕获组名称不存在,抛出异常。
func matchString()
public func matchString(): String
功能:获取上一次匹配到的子字符串,结果与调用 matchString(0) 相同。
返回值:
- String - 匹配到的子字符串。
func matchString(Int64)
public func matchString(group: Int64): String
功能:根据给定的索引获取上一次匹配中该捕获组匹配到的子字符串。
捕获组的索引从 1 开始,索引为 0 表示获取整个正则表达式的匹配结果。
参数:
- group: Int64 - 指定组。
返回值:
- String - 匹配到的子字符串。
异常:
- IllegalArgumentException - 当未开启捕获组提取,或 group 小于 0 或者大于 groupCount 时,抛出异常。
func matchString(String)
public func matchString(group: String): String
功能:根据给定的命名捕获组名称获取上一次匹配中该捕获组匹配到的子字符串。
参数:
- group: String - 指定命名捕获组的名称。
返回值:
- String - 匹配到的子字符串。
异常:
- IllegalArgumentException - 当未开启捕获组提取,或捕获组名称不存在,抛出异常。
struct Position
public struct Position {
public let end: Int64
public let start: Int64
}
功能:用来存储位置信息,表示的是一个前闭后开区间。
let end
public let end: Int64
功能:区间结束位置。
类型:Int64
let start
public let start: Int64
功能:区间开始位置。
类型:Int64