43. Kotlin通过Regex构建正则表达式

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]