Kotlin正規表示式


正則(Regex)通常是指正規表示式,用於搜尋字串或替換正規表示式物件。 要使用它,需要使用Regex(pattern:String)類。 Kotlin Regex類可以在kotlin.text.regex包中找到。

Kotlin Regex建構函式

建構函式 描述
Regex(pattern: String) 它從給定的字串模式建立正規表示式。
Regex(pattern: String, option: RegexOption) 它從給定的字串模式建立一個正規表示式並給出單個選項。
Regex(pattern: String, options: Set<RegexOption>) 它根據給定的字串模式和給定選項集建立正規表示式。

正規表示式函式

方法 描述
fun containsMatchIn(input: CharSequence): Boolean 它表示正規表示式包含至少一個輸入字元
fun find(input: CharSequence, startIndex: Int = 0): MatchResult? 它返回輸入字元序列中正規表示式的第一個匹配項,從給定的startIndex開始。
fun findAll(input: CharSequence, startIndex: Int = 0): Sequence<MatchResult> 它返回輸入字串中所有出現的正規表示式,從給定的startIndex開始。
funmatchEntire(input: CharSequence): MatchResult? 它用於匹配模式中的完整輸入字元。
infix fun matches(input: CharSequence): Boolean 它指示所有輸入字元序列是否與正規表示式匹配。
fun replace(input: CharSequence, replacement: String): String 它用給定的替換字串替換正規表示式的所有輸入字元序列。
fun replaceFirst(input: CharSequence, replacement: String): String 它用給定的替換字串替換給定輸入字串中第一次出現的正規表示式。
fun split(input: CharSequence, limit: Int = 0): List<String> 它分割正規表示式的輸入字元序列。
fun toPattern(): Patternfun toString(): String 它以字串形式返回正規表示式。

Regex 類檢查包含輸入模式的範例

fun main(args: Array<String>){
    val regex = Regex(pattern = "ko")
    val matched = regex.containsMatchIn(input = "kotlin")
    println("是否匹配:"+matched)
}

執行上面範例程式碼,得到以下結果 -

是否匹配:true

正規表示式函式的結果基於匹配正規表示式模式和輸入字串。某些函式檢查部分匹配,而某些檢查完全匹配。

containsMatchIn()正規表示式的範例

fun main(args: Array<String>){

    val regex = """a([bc]+)d?""".toRegex()
    val matched = regex.containsMatchIn(input = "xabcdy")
    println("是否匹配:"+matched)

}

執行上面範例程式碼,得到以下結果 -

是否匹配:true

matches(input: CharSequence): Boolean 正規表示式的範例

matches(input: CharSequence)正規表示式的布林函式檢查所有輸入字元序列是否匹配正規表示式。

fun main(args: Array<String>){

    val regex = """a([bc]+)d?""".toRegex()
    val matched1 = regex.matches(input = "xabcdy")
    val matched2 = regex.matches(input = "xabcdyabcd")
    val matched3 = regex.matches(input = "abcd")
    println(matched1)
    println(matched2)
    println(matched3)
}

執行上面範例程式碼,得到以下結果 -

false
false
true

matchEntire(input: CharSequence): MatchResult?正規表示式範例

matchEntire()函式用於匹配模式中的完整輸入字元。

fun main(args: Array<String>){

    val regex = Regex("abcd")
    val matchResult1 = regex.matchEntire("abcd")?.value
    val matchResult2 = regex.matchEntire("abcda")?.value

    val matchResult3 = Regex("""\d+""").matchEntire("100")?.value
    val matchResult4 = Regex("""\d+""").matchEntire("100 dollars")?.value

    println(matchResult1)
    println(matchResult2)
    println(matchResult3)
    println(matchResult4)
}

執行上面範例程式碼,得到以下結果 -

abcd
null
100
null

find(input: CharSequence, startIndex: Int = 0): MatchResult? 正規表示式範例

find函式用於從regex物件中查詢輸入字元序列。

fun main(args: Array<String>){

    val emailParttern = Regex("""\w+@[a-zA-Z_]+?\.[a-zA-Z]{2,6}""")
    val email :String? = emailParttern.find("this is my email [email protected]")?.value
    println(email)
    val phoneNumber :String? = Regex(pattern = """\d{3}-\d{3}-\d{4}""")
        .find("phone: 123-456-7890, e..")?.value
    println(phoneNumber)
}

執行上面範例程式碼,得到以下結果 -

[email protected]
123-456-7890

findAll(input: CharSequence, startIndex: Int = 0): Sequence 正規表示式範例

正規表示式的findAll()函式在提供的模式的基礎上返回匹配結果的序列。

fun main(args: Array<String>){
    val foundResults = Regex("""\d+""").findAll("ab12cd34ef 56gh7 8i")
    val result = StringBuilder()
    for (findText in foundResults) {
        result.append(findText.value + " ")
    }
    println(result)
}

執行上面範例程式碼,得到以下結果 -

12 34 56 7 8

replace(input: CharSequence, replacement: String): String 正規表示式範例

Regex replace()函式用指定的替換字串替換輸入字元序列中的所有匹配模式。

fun main(args: Array<String>){
    val replaceWith = Regex("beautiful")
    val resultString = replaceWith.replace("this picture is beautiful","awesome")
    println(resultString)
}

執行上面範例程式碼,得到以下結果 -

this picture is awesome

replaceFirst(input: CharSequence, replacement: String): String 正規表示式範例

正規表示式replaceFirst()函式用指定的替換字串替換輸入字元序列中第一次出現的匹配模式。

fun main(args: Array<String>){
    val replaceWith = Regex("beautiful")
    val resultString = replaceWith.replaceFirst("nature is beautiful, beautiful is nature","awesome")
    println(resultString)
}

執行上面範例程式碼,得到以下結果 -

nature is awesome, beautiful is nature

split(input: CharSequence, limit: Int = 0): List 正規表示式範例

regex split()函式根據提供的模式拆分輸入字元序列。 此拆分值放在List中返回。

fun main(args: Array<String>){
    val splitedValue = Regex("""\d+""").split("ab12cd34ef")
    val nonsplited= Regex("""\d+""").split("nothing match to split" )
    println(splitedValue)
    println(nonsplited)
}

執行上面範例程式碼,得到以下結果 -

[ab, cd, ef]
[nothing match to split]