Skip to content

字符串 ​

String 类型表示字符序列。你可以将其用于文本值,例如单词、句子、消息或结构化文本。

String 类型是不可变的。创建 String 对象后,其内容在它的整个生命周期中都保持不变。任何看似修改字符串的操作,实际上都会创建一个新的字符串。

声明字符串 ​

要声明一个 String 文字,请将值用双引号("")括起来。你可以显式指定 String 类型,也可以让 Kotlin 根据值推断它:

kotlin
val name: String = "Kotlin"
val message = "Hello, world!" // Kotlin 推断为 String

双引号字符串文字支持诸如 \n 或 \t 之类的转义序列:

kotlin
val message = "Hello,\nworld!"
val quote = "Kotlin says, \"Hi\"."

多行字符串 ​

若要存储由多行组成的文本,或者包含你不想转义的引号,请使用由三引号(""" """)括起来的多行字符串:

kotlin
val text = """
Hello,
Kotlin
"""

val quote = """Kotlin says, "Hi"."""

多行字符串不支持转义序列。 Kotlin 会将这些字符视为常规文本。

多行字符串会保留源代码中所写的换行与缩进。当你希望运行时值与文件中的文本排版相匹配时,此行为非常有用。

在以下示例中,每行前面的空格都是生成字符串的一部分:

kotlin
val text = """
    Hello,
    Kotlin
"""

若要移除公共的前导缩进,请使用 trimIndent() 函数。它会检测非空行的公共最小缩进并将其移除:

kotlin
fun main() {
    val text = """
        Hello,
        Kotlin
    """.trimIndent()
    
    println(text)
}

若要更显式地控制缩进的移除,请使用 trimMargin() 函数。它会移除每行中边距前缀及其之前的所有内容:

kotlin
fun main() {
    val text = """
        |Hello,
        |Kotlin
    """.trimMargin()
    
    println(text)
}

默认情况下,trimMargin() 函数使用管道符号(|)作为边距前缀,但你也可以传递另一个字符作为形参。例如:trimMargin(">")。

当你使用 trimIndent() 或 trimMargin() 等函数处理字符串时,无论在哪个平台上,生成的字符串都仅使用换行符(\n)作为分隔符。

字符串模板 ​

字符串模板允许你直接在 String 文字内部嵌入变量和表达式。这个过程称为_字符串插值_(interpolation)。你可以在常规字符串和多行字符串中使用字符串模板。

若要在字符串中插入变量,请使用 $ 符号:

kotlin
fun main() { 
    val name = "Kotlin"
    println("Hello, $name") 
    // Hello, Kotlin
}

若要在字符串中插入表达式,或者将变量直接紧邻其他文本放置,请使用 ${}:

kotlin
fun main() {
    val text = "abc"
    println("The length of $text is ${text.length}")
    // The length of abc is 3
      
    val language = "Kotlin"
    println("${language}Lang")
    // KotlinLang
}

你也可以使用 + 运算符来拼接字符串。不过,字符串模板通常更具可读性,也更符合习惯用法。

模板表达式中还可以包含未转义的双引号字符串:

kotlin
// 双引号字符串
val test = "${"test".uppercase()}"

// 多行字符串
val result = """
Result: ${"OK".lowercase()}
"""

字符串模板中的可空值 ​

如果插值表达式或变量的求值结果为 null,Kotlin 编译器会在生成的字符串中插入文本 null。若要将 null 替换为其他值,请使用 Elvis 运算符(?:):

kotlin
fun main(){
    val text: String? = null
  
    println("Hello, $text")
    // Hello, null

    println("Hello, ${text ?: "Kotlin"}")
    // Hello, Kotlin
}

多美元符号字符串插值 ​

在常规字符串模板中,单个美元符号($)即可开启插值。如果你需要在字符串中包含美元符号字面量,请使用多美元符号字符串插值。

多美元符号字符串插值允许你指定需要多少个连续的美元符号来触发插值。少于该数量的美元符号将被视为普通字面字符。

例如,当你在字符串文字前使用 $$ 时,插值仅由两个连续的美元符号开启:

kotlin
val KClass<*>.jsonSchema : String
    get() = $$"""
    {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "$id": "https://example.com/product.schema.json",
      "$dynamicAnchor": "meta",
      "title": "$${simpleName ?: qualifiedName ?: "unknown"}",
      "type": "object"
    }
    """

如果你使用单美元符号字符串插值,多美元符号字符串插值不会对你的代码产生影响。你可以继续使用单个 $,并在需要时应用多个美元符号。

基本字符串操作 ​

Kotlin 提供了一系列用于处理字符串的操作。本节将介绍一些最常用的操作。

在 API 参考中详细了解所有可用函数。

获取字符串长度 ​

若要获取字符串中的字符数,请使用 length 属性:

kotlin
fun main (){
    val language = "Kotlin"
    println(language.length)
    // 6
}

访问字符 ​

你可以使用索引运算符([])访问字符串中的单个字符:

kotlin
fun main (){
    val language = "Kotlin"
    
    println(language[0])
    // K
    println(language[5])
    // n
}

字符串索引从零开始。 如果你尝试访问有效范围之外的索引,Kotlin 将抛出异常。

你还可以遍历字符串中的字符:

kotlin
fun main(){
    for (char in "Kotlin") {
      println(char)
    }
}

提取字符串的各部分 ​

若要提取字符串的某些部分,请使用以下函数之一:

  • substring():返回包含原始文本选定部分的新字符串。
  • subSequence():返回包含原始文本选定部分的 CharSequence。

例如:

kotlin
fun main() {
    val text = "Kotlin"
    println(text.substring(1))
    // otlin
    println(text.substring(1, 5))
    // otli
    println(text.subSequence(1, 5))
    // otli
}

由于 String 类型是不可变的,因此这些函数不会修改原始字符串。

比较字符串 ​

你可以使用 == 运算符检查两个字符串是否具有相同的内容:

kotlin
fun main(){
    println("kotlin" == "kotlin")
    // true
  
    println("kotlin" == "Kotlin")
    // false
}

你还可以使用 compareTo() 函数按字典序(逐字符)比较字符串。它会扫描两个字符串,直到找到第一对不同的字符,并返回:

  • 当字符串相等时返回 0。
  • 当接收者小于实参时返回小于 0 的值。
  • 当接收者大于实参时返回大于 0 的值。
kotlin
fun main() {
    println("abc".compareTo("abd") < 0)
    // true
    
    println("abc".compareTo("ABC") > 0)
    // true
    
    // 传入 true 以忽略大小写差异
    println("abc".compareTo("ABC", ignoreCase = true) == 0)
    // true
}

处理字符串内容 ​

如果你想更改字符串的内容,可以使用诸如 .trim()、.replace()、.uppercase() 以及 .lowercase() 等函数来创建其修改后的副本:

kotlin
fun main() {
    val text = "  Hello, Kotlin  "

    println(text.trim())
    // Hello, Kotlin

    println(text.replace("Kotlin", "world"))
    //   Hello, world  

    println(text.uppercase())
    //   HELLO, KOTLIN  

    println(text.lowercase())
    //   hello, kotlin  
}

你还可以使用 contains()、startsWith() 和 endsWith() 函数来检查字符串内容:

kotlin
fun main() { 
    val domain = "kotlinlang.org"
    
    // 检查字符串是否包含 "."
    println(domain.contains("."))
    // true
    
    // 检查字符串是否以 "kotlin" 开头
    println(domain.startsWith("kotlin"))
    // true
    
    // 检查字符串是否以 ".org" 结尾
    println(domain.endsWith(".org"))
    // true
}

拆分字符串 ​

你可以使用 split() 函数以分隔符为界将字符串拆分成若干部分:

kotlin
fun main() { 
    val numbers = "one, two, three"
    println(numbers.split(", "))
    // [one, two, three]
}

如果你想将字符串拆分为单独的行,请使用 lines() 函数:

kotlin
fun main() { 
    val numbers = "one\ntwo\nthree"
    println(numbers.lines())
    // [one, two, three]
}

构建与格式化字符串 ​

在 Kotlin 中,对于大多数格式化任务,请使用字符串模板。

当你使用 + 运算符进行字符串串联时,Kotlin 会为每次操作创建一个新的 String 对象。然而,在循环中或组装许多片段时,这种方式可能并不理想。为了避免此类问题,你可以使用 buildString() 函数或 StringBuilder。它们会将所有片段收集到一个可变缓冲区中,并最终只生成一个字符串。

当决定追加内容的逻辑较为复杂时,请使用 buildString() 函数。例如,当你存在多个生成不同片段的条件时。使用 buildString(),你不需要直接操作缓冲区。该函数会在内部创建一个 StringBuilder,运行你的代码块,并返回生成的字符串。

kotlin
fun main() {

    val hasErrors = true
    val hasWarnings = true
    val isComplete = false
    
    // buildString 创建一个空缓冲区
    val status = buildString {
        // 向缓冲区追加 "Errors found"
        if (hasErrors) append("Errors found")
        if (hasWarnings) {
            // 缓冲区非空,追加 "; "
            if (isNotEmpty()) append("; ")
            // 追加 "Warnings found"
            append("Warnings found")
        }
        // isComplete = false,无追加内容
        if (isComplete) {
            if (isNotEmpty()) append("; ")
            append("Completed")
        }
        // 缓冲区非空,跳过备选内容
        if (isEmpty()) append("OK")
    }
    
    println(status)
    // Errors found; Warnings found
}

当你需要将缓冲区作为显式值使用时,请使用 StringBuilder。例如,用于修改现有文本:

kotlin
fun main() {
    val text = "Hello, Kotlin"
    val builder = StringBuilder(text)

    builder.replace(7, 13, "world")
    println(builder.toString()) 
    // Hello, world
}

在 JVM 上,你还可以使用 String.format() 函数来格式化字符串:

kotlin
val text = String.format("Hello, %s", "Kotlin")

仅当你在 JVM 上特别需要格式化程序样式(formatter-style)的说明符时,才使用 String.format() 函数。 请在 Java Formatter 类文档中详细了解格式说明符。

字符串转换 ​

通常你可能会使用字符串来表示其他类型的值,例如数字、Boolean 值或来自输入的标识符。Kotlin 提供了用于将值转换为字符串以及将字符串解析为其他类型的函数。

若要返回某个值的字符串表示形式,请使用 toString() 函数:

kotlin
val number = 10
val text = number.toString()

在字符串模板和字符串串联中,Kotlin 会自动将值转换为字符串。

若要将字符串转换为其他类型,请使用对应的解析函数:

如果字符串格式有效,这些函数将返回请求类型的值。如果输入可能无效,请使用带有 OrNull 的变体。这些函数会返回 null 而不是抛出异常,从而使其能够安全地用于用户输入或你无法完全控制的数据:

kotlin
val toInt = "10".toInt() // 10

// 1000000000000 超出了 Int 的最大值
val toIntInvalid = "1000000000000".toIntOrNull()

val toBoolean = "true".toBooleanStrict() // true
val toBooleanInvalid = "yes".toBooleanStrictOrNull() // null