Skip to content

字符 ​

Char 类型将单个字符表示为一个 UTF-16 代码单元。

对于单个字符值,例如字母、数字、标点符号或空格,请使用 Char。对于字符序列,请使用 String。

Char 不是数值类型,但每个字符都有一个可供访问的数值型 Unicode 值。 请参阅字符转换。

语法 ​

要声明一个字符,请将值括在单引号(' ')中。你可以显式指定 Char 类型,或者让 Kotlin 根据该值进行推断:

kotlin
val letter: Char = 'a'

// Kotlin 推断类型为 Char,因为这些值写在单引号中
val digit = '1'
val symbol = '!'
val space = ' '
val separator = ':'

字符字面值必须恰好包含一个字符。否则,Kotlin 编译器会报错:

kotlin
val invalid = 'AB' // 错误
val invalidEmpty = '' // 错误

可空值 ​

要存储可空值,请使用 Char?:

kotlin
val maybeAbsent: Char? = null

在 JVM 上,可空的 Char 值在需要时会被装箱。这同样适用于 数值类型。

Unicode 支持 ​

Kotlin 将 Char 值表示为 UTF-16 代码单元。这意味着单个 Char 存储一个 UTF-16 代码单元,不一定代表一个完整的 Unicode 字符。

基本多语言平面 ​

单个 Char 可以存储从 \u0000 到 \uFFFF 范围内的值。该范围覆盖了基本多语言平面 (BMP),其中包括几乎所有现代语言的字符以及大量符号。

要通过 Unicode 值指定字符,请使用 \u 后跟来自 Unicode 码表 的四位十六进制值:

kotlin
val unicodeNumber = '\u0031' // 等同于 '1'

增补字符 ​

超出 BMP 的 Unicode 字符(例如 Emoji 和某些历史文字)无法用单个 Char 表示。在 UTF-16 中,它们被编码为代理对(surrogate pair),在 String 中由两个 Char 值共同表示一个 Unicode 字符:

kotlin
fun main() {
    val emoji = "🥦"
    
    println(emoji.length) // 2
    println(emoji[0])     // 首个代理项
    println(emoji[1])     // 第二个代理项
}

若要单独处理 32 位符号,请使用存储为 Int 值的 Unicode 码点。

转义序列 ​

对于难以直接写入源代码中或具有特殊含义的特殊字符,请使用转义序列。

每个转义序列均以反斜杠(\)开头。

支持的序列说明
\t制表符 (Tab)
\b退格键 (Backspace)
\n换行 (LF)
\r回车 (CR)
\'单引号
\"双引号
\\反斜杠
\$美元符号

例如:

kotlin
val newLine = '\n'
val dollar = '\$'
val backslash = '\\'

操作 ​

Char 支持比较、检查、大小写转换和显式数值转换。

字符比较 ​

要比较 Char 值,请使用标准比较运算符,如 ==、!=、<、>、<= 和 >=。

Kotlin 根据字符的数值型 Unicode 值进行比较,并返回一个 Boolean 值:

kotlin
val before = 'a' < 'b' // true
val after = 'c' > 'd' // false
val different = 'A' == 'a' // false 
val equal = 'A' == 'A' // true

字符处理 ​

Kotlin 提供了用于字符值检查和大小写转换的函数。例如:

kotlin
fun main() {
    val myChar = 'A'
    // 检查字符是否为数字
    println(myChar.isDigit()) // false
    // 检查字符是否为大写字母
    println(myChar.isUpperCase()) // true
    // 返回小写形式
    println(myChar.lowercaseChar()) // 'a'
}

要详细了解可用函数,请参阅 API 参考。

字符算术运算 ​

你可以通过加上或减去一个整数来创建另一个字符值:

kotlin
fun main() {
    val a = 'a'

    println(a + 1)  // b
    println(a + 2)  // c
    println(a - 32) // A
}

这些操作遵循 Unicode 值规则,而不是特定语言的字母表规则。

你还可以对可变变量使用前缀和后缀形式的自增(++)与自减(--)运算符:

kotlin
fun main() {
    var a = 'A'
    
    a += 10
    println(a)   // 'K'
    
    println(++a) // 'L'  前缀自增
    println(a++) // 'L'  后缀自增
    println(a)   // 'M'
    
    println(--a) // 'L'  前缀自减
    println(a--) // 'L'  后缀自减
    println(a)   // 'K'
}

字符转换 ​

要将 Char 转换为数值类型,请使用显式转换:

  • 使用 .code 获取字符的数值型 Unicode 值:

    kotlin
    fun main() { 
        val letter = 'A'
        println(letter.code) // 65
    }
  • 如果字符表示十进制数字,请使用 digitToInt():

    kotlin
    fun main() { 
        val digit = '7'
        println(digit.digitToInt()) // 7
    }

    如果该字符可能不是有效数字,请使用 digitToIntOrNull()。