Kotlinのwhen式を完全ガイド！初心者でもわかるパターンマッチング的な使い方

1. Kotlinのwhen式とは？

1. Kotlinのwhen式とは？

when式（うぇんしき）とは、1つの値に対して「この場合はこうする」「別の場合はこう動く」といった振る舞いを分けたいときに使うKotlinの便利な構文です。英語の “when（〜のとき）” がそのまま名前になっていることからもわかるように、「〜のときに実行する処理」を順番に書ける仕組みになっています。

たとえば「1なら大吉、2なら中吉、3なら凶、それ以外なら不明」といった複数の条件をまとめたいとき、if文をいくつも重ねると読みにくくなりますが、when式を使えばすっきり書けます。初心者でも視覚的に理解しやすく、どの条件に対応しているのかが一目でわかるのが大きな特徴です。

また、Kotlinのwhen式は、他の言語にある「switch文」に似ているものの、値の一致だけでなく条件式にも使えるなど柔軟性が高い構文です。まずはシンプルな例を見ながら、when式がどのように振る舞うのかイメージを掴んでみましょう。

fun main() {
    val number = 1
    val result = when (number) {
        1 -> "大吉"
        2 -> "中吉"
        else -> "その他"
    }
    println(result)  // 大吉
}

このように、変数の値に応じて処理を切り替えるのがwhen式の基本です。まずは、「条件をきれいに整理するための道具」として覚えるとよいでしょう。

2. 基本的なwhen式の使い方

2. 基本的なwhen式の使い方

when式の一番シンプルな使い方は、「1つの値を見て、その値ごとにやることを変える」という書き方です。イメージとしては、「おみくじの番号を見て結果を決める表」をコードで書くような感覚です。同じ変数に対して条件を分けたいときは、if文を何個も重ねるより、when式でまとめたほうがスッキリ読みやすくなります。

基本の形は次のようになります。

when (調べたい値) { パターン -> 実行する処理 } という形で、「この値のときはこの処理」という対応関係を縦に並べていきます。

fun main() {
    val number = 2

    val result = when (number) {
        1 -> "大吉"
        2 -> "中吉"
        3 -> "凶"
        else -> "不明"
    }

    println(result)
}

このコードでは、まずnumberという変数に2を入れています。when (number)のあとのブロックで、1 のときは "大吉"、2 のときは "中吉"、3 のときは "凶"というように、値ごとの結果を矢印（->）を使って書いています。

elseは「どの条件にも当てはまらなかったとき」の受け皿です。たとえばnumberが4だった場合は、どの行にも一致しないので"不明"が選ばれます。このwhen式全体の結果がresultに入るので、最後のprintln(result)でその文字が表示されます。

中吉

このように、when式を使うと「どの値のときに何をするか」が縦にきれいに並ぶため、プログラミング初心者でも流れを追いやすくなります。同じ変数に対して分岐したいときは、まずwhen (値) { ... }という書き方を思い出してみてください。

3. when式は「式」なので値を返す

3. when式は「式」なので値を返す

Kotlinのwhenは、名前のとおり「when式」と呼ばれます。ここでいう「式（しき）」とは、計算した結果として値を1つ返すもののことです。たとえば1 + 2と書けば結果として3という値が返ってきますが、whenも同じように「結果を1つ決めて返す」ことができます。

先ほどの「おみくじ」の例では、whenの結果として「大吉」「中吉」「凶」などの文字列が選ばれ、それが丸ごとresultという変数に代入されていました。もう一度、少しだけ書き方を整理して見てみましょう。

fun main() {
    val number = 2

    // when式が1つの値（文字列）を返して result に入る
    val result = when (number) {
        1 -> "大吉"
        2 -> "中吉"
        3 -> "凶"
        else -> "不明"
    }

    println("結果は $result です")
}

ここでは、when (number) { ... }全体が1つの「式」として評価され、「中吉」などの文字列が返ってきます。その返ってきた値をresultに入れ、最後にprintlnでまとめて表示しています。

式として使えるおかげで、変数に代入するだけでなく、次のようにprintlnの中に直接書くこともできます。

fun main() {
    val number = 3

    println(
        when (number) {
            1 -> "大吉"
            2 -> "中吉"
            3 -> "凶"
            else -> "不明"
        }
    )
}

このサンプルでは、when式が返した文字列を、そのままprintlnに渡しています。whenが「式」でなければ、このように関数の引数として直接書くことはできません。プログラミング初心者の方は、「when式は結果を1つ決めて返してくれる便利な仕組み」とイメージしておくと、ほかのサンプルコードを読んだときにも理解しやすくなります。

4. 値だけでなく条件も使える！

4. 値だけでなく条件も使える！

ここまでの例では「番号が1なら大吉」のように“値が一致したとき”の処理を見てきましたが、Kotlinのwhen式はそれだけではありません。同じ形のまま、条件そのものを書くことができるため、数値の範囲や状況に応じて柔軟に分岐を作ることができます。これはif文をいくつも重ねた場合よりも読みやすく、コードの意図も伝わりやすくなります。

たとえば学校のテストの点数によって評価を決めたいとき、score が 90点以上ならA、70点以上ならBというように条件を並べて書くことができます。次のサンプルは、その流れをwhen式でまとめたものです。

fun main() {
    val score = 85

    // when( ) を空にすることで条件式をそのまま書ける
    val grade = when {
        score >= 90 -> "A"
        score >= 70 -> "B"
        score >= 50 -> "C"
        else -> "D"
    }

    println("評価は $grade です")
}

評価は B です

このサンプルのポイントは、whenのかっこを空にしていることです。こうすることで、「score がどの条件を満たしているか」を上から順番に判定し、一番最初に当てはまった結果を返します。if → else if → elseと書くよりも形がすっきりし、条件が増えても読みやすさが保たれるのが大きなメリットです。

また、条件式をそのまま書けるので、「温度が一定以上なら警告を出す」「残高が少なければ通知する」といった日常的な判断ロジックにも応用できます。状況に応じて柔軟に処理を分岐できる点が、when式の強みです。

5. 複数の値をまとめて分岐できる

5. 複数の値をまとめて分岐できる

同じ処理をしたいケースが複数あるとき、ひとつずつ条件を書くのは手間ですし、コードも長くなってしまいます。そんなときに便利なのが、when式で「複数の値をまとめて扱える」という特徴です。Kotlinでは、カンマ区切りで値を並べるだけで、「これらに当てはまるときは同じ処理を実行する」という読みやすい書き方ができます。

fun main() {
    val day = "土曜日"

    val type = when (day) {
        // 土日が来たらどちらも「休日」という結果にする
        "土曜日", "日曜日" -> "休日"

        // 平日をまとめて扱う
        "月曜日", "火曜日", "水曜日", "木曜日", "金曜日" -> "平日"

        else -> "不明"
    }

    println(type)
}

休日

この仕組みのおかげで、「土曜日なら休日」「日曜日なら休日」といったように似た条件を何度も書かずにすみ、コードの意図もひと目で伝わりやすくなります。特に“分類”を行いたい場面──たとえば「赤・青・黄なら基本色」「猫・犬ならペット」など──にも応用でき、プログラミング初心者でも自然に読み解ける形に整理できます。

6. when式と変数の型（たとえば文字列）

6. when式と変数の型（たとえば文字列）

when式は、数値だけでなく文字列やその他の型（たとえばCharやBooleanなど）にも使えます。

次の例は、文字列に対して反応するwhenです。

fun main() {
    val input = "こんにちは"
    val response = when (input) {
        "こんにちは" -> "やあ！"
        "おはよう" -> "おはようございます！"
        "こんばんは" -> "こんばんは〜"
        else -> "なんと言ったの？"
    }
    println(response)
}

やあ！

このように、文字列でもwhenは自由自在に使えます。入力に応じた返答を作るプログラムにも向いています。

7. when式を使うとコードが読みやすくなる理由

7. when式を使うとコードが読みやすくなる理由

初心者のうちはif文をたくさん書いてしまいがちですが、条件が多くなると見づらくなります。

when式を使うことで、条件をスッキリ整理して、誰が見ても読みやすいコードにできます。

特に、同じ変数の値によって処理を分けたいときには、when式が最適です。

まとめ

まとめ

ここまで、Kotlinのwhen式を中心にさまざまな条件分岐の書き方を学んできましたが、振り返ってみると、when式がいかに柔軟で読みやすい構文であるかがよく分かります。複数の条件を整理しながらまとめて記述できるため、初心者でもスムーズに扱える点が魅力です。また、値だけでなく条件式そのものを利用して分岐できる特性は、点数評価や文字列による振る舞いの変化など、日常的な処理にも応用しやすいでしょう。さらにwhen式は「式」として値を返すため、プログラムの記述が簡潔になり、結果を変数に直接代入するスタイルが自然に身につきます。

たとえば休日と平日を判定する処理でも、複数の文字列をカンマでまとめて一行に整理することで、コード全体の見通しが非常によくなります。こうした書き方は条件分岐が多くなるアプリケーション開発において役立ち、読み手が迷わず理解できる設計へとつながります。特にスマートフォンアプリやデータ処理で入力パターンが増える場合、when式を活用して分岐のルールを視覚的に整理することが重要です。

また、文字列や数値だけでなく、型ごとに適した分岐を行うことで、ユーザー入力に応じたメッセージ表示や機能切り替えといった処理を柔軟に作成できます。条件の粒度を丁寧に分け、読みやすい構造に仕上げることはプログラムの品質を高める第一歩であり、Kotlinのwhen式はその基礎を身につけるために最適な構文と言えるでしょう。学習を進めるうちに、さまざまな分岐パターンを扱えるようになり、より高度なロジックへ応用できるようになるはずです。

サンプルプログラムでもう一度整理しよう

ここでは、あらためて複数のパターンをまとめて処理できるwhen式の利点を確認してみましょう。次のコードは、ユーザーが入力した値に応じて画面表示を切り替えるシンプルな例です。

fun main() {
    val command = "start"

    val message = when (command) {
        "start", "run", "go" -> "アプリを起動します"
        "stop", "end" -> "アプリを終了します"
        "help" -> "ヘルプを表示します"
        else -> "不明なコマンドです"
    }

    println(message)
}

このように、複数の文字列をまとめて同じ分岐に整理することで、読みやすさと拡張性を両立できます。現場でよく見るコマンド処理やユーザー操作の分岐にも応用しやすいので、自分のアプリケーションでもぜひ活用してみてください。

この記事を読んだ人からの質問

この記事を読んだ人からの質問

プログラミング初心者からのよくある疑問／質問を解決します

Kotlinのwhen式とif文の違いは何ですか？どちらを使えば読みやすいコードになりますか？

Kotlinのwhen式は、複数の条件をすっきり整理できる構文で、if文よりも条件分岐が多い場合に読みやすくなります。同じ変数の値に応じて処理を分けたいときはwhen式、複雑な一つの条件をチェックしたいときはif文が向いています。

Kotlinのwhen式はswitch文と同じですか？どんな点が違いますか？

switch文に似ていますが、Kotlinのwhen式はより柔軟で高機能です。複数の値をまとめて処理できたり、値だけでなく条件式も使えたり、式として値を返せる点が違いです。

when式は「式」とされていますが、式として値を返すメリットは何ですか？

when式が値を返すことで、その結果をそのまま変数に代入したり、関数の戻り値として利用できるため、コードが短く整理されて読みやすくなります。