Kotlin 提供了一个正则表达式类 Regex。
Regex 提供了丰富而简单实用的函数。
| 函数名称 | 功能说明 |
|---|---|
| matches(input: CharSequence): Boolean | 输入字符串全部匹配 |
| containsMatchIn(input: CharSequence): Boolean | 输入字符串至少有一个匹配 |
| matchEntire(input: CharSequence): MatchResult? | 输入字符串全部匹配，返回一个匹配结果对象 |
| replace(input: CharSequence, replacement: String): String | 把输入字符串中匹配的部分替换成replacement的内容 |
| replace(input: CharSequence, transform: (MatchResult) -> CharSequence): String | 把输入字符串中匹配到的值，用函数 transform映射之后的新值替换 |
| find(input: CharSequence, startIndex: Int = 0): MatchResult? | 返回输入字符串中第一个匹配的值 |
| findAll(input: CharSequence, startIndex: Int = 0): Sequence<MatchResult> | 返回输入字符串中所有匹配的值MatchResult的序列 |
matches
输入的字符串全部匹配“正则表达式”返回 true，否则返回 false。
val r1 = Regex("[a-z]+")
println(r1.matches("ABCdef"))
val r2 = Regex("[a-z]+", RegexOption.IGNORE_CASE) //忽略大小写
println(r2.matches("ABCdef"))
val r3 = Regex("[A-Z]+")
println(r3.matches("ABC"))
val r4 = "[A-Z]+".toRegex()
println(r4.matches("ABCDEFXYZ"))
运行结果
false
true
true
true
containsMatchIn
输入的字符串中至少有一个匹配就返回 true，否则就返回 false。
val r5 = Regex("[0-9]+")
println(r5.containsMatchIn("012abdc"))
println(r5.containsMatchIn("JAVAI"))
运行结果
true
false
matchEntire
对字符串全部做比较，都匹配正则表达式返回一个MatcherMatchResult对象，否则返回 null。
val r6 = Regex("[0-9]+")
println(r6.matchEntire("1234567890"))
println(r6.matchEntire("1234567890!"))
println(r6.matchEntire("1234567890")?.value)
当我们使用 MatcherMatchResult 的 value 值来显示匹配结果，由于 matchEntire 函数有可能返回一个 null，所以这里使用了安全调用符号“？”。
运行结果
kotlin.text.MatcherMatchResult@1fb3ebeb
null
1234567890
replace
replace(input: CharSequence, replacement: String): String
输入的字符串匹配的部分替换成 replacement 的内容。
val r7 = Regex("[0-9]+")
println(r7.replace("12345XYZ33", "abcd"))
这个例子是把数字替换成了 abcd。
replace函数
函数签名 replace(input: CharSequence, transform: (MatchResult)->CharSequence): String
它的功能是把输入的字符串中匹配的值，用函数 transform 映射之后的新值进行替换。
val r8 = Regex("[0-9]+")
println(r8.replace("12XYZ9", {(it.value.toInt() * it.value.toInt()).toString()}))
我们可以看到，输入的字符串中有两个数字，一个是 12 在字符串的前部，一个是 9 在字符串的后部。
运行结果
144XYZ81
12 被替换成了 144，9 被替换成了 81。
find函数
返回字符串中第一个匹配的 MatcherMatchResult 对象
val r9 = Regex("[0-9]+")
println(r9.find("123ADPOIW87WEERUU005"))
println(r9.find("123ADPOIW87WEERUU005")?.value)
这段代码，会匹配123，而使用了 value 值的方式显示出的结果，我们更加容易理解。
运行结果
kotlin.text.MatcherMatchResult@1fb3ebeb
123
findAll
返回输入的字符串中所有匹配的值的 MatchResult 序列。
我们可以通过 forEach 循环遍历显示所有匹配结果
val src2 = "电话:010-12345678;传真:010-10171695;备用:010-20141017"
val re2 = """(\d{3}-\d{8})""" //"\\d{3}-\\d{8}"
Regex(re2).findAll(src2).forEach { println(it.value + " 位置：[" + it.range + "]") }
运行结果
010-12345678 位置：[3..14]
010-10171695 位置：[19..30]
010-20141017 位置：[35..46]
