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 = ':'

文字リテラルには、正確に1文字だけを含める必要があります。そうでない場合、Kotlinコンパイラはエラーを報告します:

kotlin
val invalid = 'AB' // エラー
val invalidEmpty = '' // エラー

Null許容値 ​

null許容の値を格納するには、Char? を使用します:

kotlin
val maybeAbsent: Char? = null

JVM上では、必要に応じてnull許容の Char 値がボックス化(box)されます。これは 数値型にも同様に当てはまります。

Unicodeサポート ​

Kotlinは Char 値をUTF-16コードユニットとして表します。これは、単一の Char が1つのUTF-16コードユニットを格納することを意味し、必ずしも1つの完全なUnicode文字を表すとは限りません。

基本多言語面 ​

単一の Char は、\u0000 から \uFFFF の範囲の値を格納できます。 この範囲は、ほぼすべての現代言語の文字と多数の記号を含む基本多言語面(Basic Multilingual Plane: BMP)をカバーしています。

Unicode値によって文字を指定するには、\u の後にUnicode表の4桁の16進数値を指定します:

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

補助文字 ​

絵文字や一部の歴史的な文字など、BMP外のUnicode文字は単一の Char では表現できません。UTF-16ではこれらはサロゲートペア(surrogate pair)としてエンコードされ、String 内で2つの Char 値が合わさって1つのUnicode文字を表します:

kotlin
fun main() {
    val emoji = "🥦"
    
    println(emoji.length) // 2
    println(emoji[0])     // 1つ目のサロゲート
    println(emoji[1])     // 2つ目のサロゲート
}

32ビットの記号を個別に扱うには、Int 値として格納されたUnicodeコードポイントを使用してください。

エスケープシーケンス ​

ソースコードに直接記述することが困難な特殊文字や、特別な意味を持つ文字にはエスケープシーケンスを使用します。

すべてのエスケープシーケンスはバックスラッシュ(\)で始まります。

サポートされているシーケンス説明
\tタブ
\bバックスペース
\n改行 (LF)
\r復帰 (CR)
\'シングルクォーテーション
\"ダブルクォーテーション
\\バックスラッシュ
\$ドル記号

例:

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

操作 ​

Char は、比較、検査、大文字・小文字の変換、および明示的な数値変換をサポートしています。

文字の比較 ​

Char 値を比較するには、==、!=、<、>、<=、>= などの標準的な比較演算子を使用します。

Kotlinは Char 値をその数値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 を数値型に変換するには、明示的な変換を使用します:

  • 文字の数値Unicode値を取得するには .code を使用します:

    kotlin
    fun main() { 
        val letter = 'A'
        println(letter.code) // 65
    }
  • 文字が10進数の数字を表している場合は、digitToInt() を使用します:

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

    文字が有効な数字ではない可能性がある場合は、digitToIntOrNull() を使用してください。