一、字符串字面量

• 普通字符串：使用双引号 " 括起来的字符串。
• 原始字符串：使用三个双引号 """ 括起来的字符串。

val a = "你好。"      //  你好。      普通字符串
val b = """你\n好"""  //  你\n好     原始字符串

二、不可变字符串

1. 定义

2. 字符串拼接：可以使用 + 和 += 运算符拼接字符串。

val a = "hello"
var b = a + " "    // "hello "
b += "world"       // "hello world"

3. 字符串模板：字符串模板以$开头

val age = 18
val s1 = "你的年龄是${age}岁。"
val now = java.util.Date()
val s2 = "今天是${now.year + 1900}年${now.month}月${now.day}日"
val s3 = """今天是:
${now.year + 1900}年
${now.month}月
${now.day}日
"""

4. 字符串查找：String类中提供了 indexOf 和 lastIndexOf 函数用于查找字符或字符串。

• indexOf：从前往后查找字符或字符串，返回第一次找到字符或字符串所在处的索引，没有找到返回-1。

fun String.indexOf(
    char: Char,                     // 要查找的字符
    startIndex: Int = 0,            // 指定查找开始的索引
    ignoreCase: Boolean = false     // 是否忽略大小写进行匹配
): Int

fun String.indexOf(
    string: String,                 // 要查找的字符串
    startIndex: Int = 0,            // 指定查找开始的索引
    ignoreCase: Boolean = false     // 是否忽略大小写进行匹配
): Int

• lastIndexOf：从后往前查找字符或字符串，返回第一次找到字符或字符串所在处的索引，没有找到返回-1。

fun String.lastIndexOf(
    char: Char,                     // 要查找的字符
    startIndex: Int = 0,            // 指定查找开始的索引
    ignoreCase: Boolean = false     // 是否忽略大小写进行匹配
): Int

fun String.lastIndexOf(
    string: String,                 // 要查找的字符串
    startIndex: Int = 0,            // 指定查找开始的索引
    ignoreCase: Boolean = false     // 是否忽略大小写进行匹配
): Int

5. 字符串比较

• 比较相等：equals、==、!=
• 比较大小：compareTo函数按字典顺序比较两个字符串。如果当前字符串等于参数字符串，则返回0；如果当前字符串位于参数字符串之前，则返回一个小于0的值；如果当前字符串位于参数字符串之后，则返回一个大于0的值。

fun String.compareTo(other: String, ignoreCase: Boolean = false): Int

• 比较前缀和后缀

fun String.startsWith(prefix: String, ignoreCase: Boolean = false): Boolean
fun String.endsWith(suffix: String, ignoreCase: Boolean = false): Boolean

5. 字符串截取

• 指定整数区间截取字符串函数：

fun String.substring(range: IntRange): String

• 从指定索引 startIndex 开始截取直到字符串结束的子字符串：

fun String.substring(startIndex: Int): String

• 从指定索引 startIndex 开始截取直到索引 endIndex-1 处的字符，注意包括索引为 startIndex 处的字符，但不包括索引为 endIndex 处的字符：

fun String.substring(startIndex: Int, endIndex: Int): String

// 案例
fun main(args: Array<String>) {
    val sourceStr = "There is a string accessing example."
    // 截取 example. 字符串
    val subStr1 = sourceStr.substring(28)      // example.
    // 截取 string 字符串
    val subStr2 = sourceStr.substring(11, 17)  // string
    // 参数是区间
    val subStr3 = sourceStr.substring(11..17)  // string
}

三、可变字符串

1. StringBuilder

2. 字符串追加、插入、删除和替换

四、正则表达式

1. 创建 Regex 对象

fun main(args: Array<String>) {
    val pattern = """\w+@[a-zA-Z_]+?\.[a-zA-Z]{2,3}"""
    val string = "kotlin@sina.com"
    // val regex = Regex(pattern)  // 通过构造函数创建
    val regex = pattern.toRegex()  // 使用 toRegex() 扩展函数
    
    println(regex.matches(string))  // true
}

2. 字符串匹配

fun main(args: Array<String>) {
    // 全部是数字模式
    val regex = Regex("""\d+""")

    val input1 = "1000"
    val input2 = "￥1000"

    println(regex.matches(input1))  // true
    println(regex.matches(input2))  // false

    println(regex.containsMatchIn(input1))  // true
    println(regex.containsMatchIn(input2))  // true
}

3. 字符串查找

fun main(args: Array<String>) {
    val string = "AB12CD34EF"
    val regex = Regex("""\d+""")
    val result = regex.find(string)
    
    println("第一个匹配字符串：${result?.value}")
    regex.findAll(string).forEach { item -> 
        println(item.value)
    }
}
// 输入结果
// 第一个匹配字符串：12
// 12
// 34

4. 字符串替换

fun main(args: Array<String>) {
    val string = "AB12CD34EF"
    val regex = Regex("""\d+""")
    val result = regex.replace(string, " ")

    println(result) // AB CD EF
}

5. 字符串分割

fun main(args: Array<String>) {
    
    val string = "AB12CD34EF"
    
    val regex = Regex("""\d+""")
    
    val result = regex.split(string)

    println(result) // [AB, CD, EF]
    
}