正則(Regex)通常是指正規表示式,用於搜尋字串或替換正規表示式物件。 要使用它,需要使用Regex(pattern:String)
類。 Kotlin Regex
類可以在kotlin.text.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(): Pattern 或 fun toString(): String |
它以字串形式返回正規表示式。 |
fun main(args: Array<String>){
val regex = Regex(pattern = "ko")
val matched = regex.containsMatchIn(input = "kotlin")
println("是否匹配:"+matched)
}
執行上面範例程式碼,得到以下結果 -
是否匹配:true
正規表示式函式的結果基於匹配正規表示式模式和輸入字串。某些函式檢查部分匹配,而某些檢查完全匹配。
fun main(args: Array<String>){
val regex = """a([bc]+)d?""".toRegex()
val matched = regex.containsMatchIn(input = "xabcdy")
println("是否匹配:"+matched)
}
執行上面範例程式碼,得到以下結果 -
是否匹配:true
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()
函式用於匹配模式中的完整輸入字元。
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
函式用於從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()
函式在提供的模式的基礎上返回匹配結果的序列。
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
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()
函式用指定的替換字串替換輸入字元序列中第一次出現的匹配模式。
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
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]