Kotlinのthrow文の使い方！例外を明示的に投げる方法

1. throw文とは？（意図的にエラーを発生させる理由）

1. throw文とは？（意図的にエラーを発生させる理由）

Kotlinのthrow文は、プログラムの中で「ここでおかしいことが起きた！」と明示的に宣言し、あえて例外（エラー）を発生させるための命令です。

「エラーは出ない方がいいのでは？」と思うかもしれませんが、実は逆です。例えば、銀行の引き出し処理で残高が足りないのに処理が進んでしまったら大変ですよね？そういった「プログラム的にあり得ない状況」が発生した際、throwを使って即座に処理を中断させることで、重大なバグやデータの破損を未然に防ぐことができるのです。

throwが実行されると、その後の処理は一切行われず、プログラムは「このエラーを解決できる人（catch文など）」を探しにいきます。もし誰も解決してくれない場合は、アプリが停止します。

fun main() {
    println("処理を開始します")

    // throwを実行した瞬間に、これ以降のコードは無視されます
    throw Exception("重大なエラーが発生しました！")

    println("この行は実行されません") 
}

このように、throwの直後に指定した「例外オブジェクト」が、エラーの原因や詳細を呼び出し元に伝えるメッセージカードのような役割を果たします。

2. throw文の基本構文と使い方

2. throw文の基本構文と使い方

Kotlinで「意図的にエラーを発生させる」ために使用するのがthrow文です。プログラムを実行している途中で、「これ以上処理を続けると問題がある」と判断したときに、自ら例外を投げることができます。

まずは、最もシンプルな書き方を見てみましょう。プログラミングが初めての方でも、以下のコードで「エラーを投げる」イメージを掴んでみてください。

fun main() {
    // 例外（エラー）を意図的に発生させる
    throw Exception("システムに予期せぬエラーが発生しました")
}

このコードを実行すると、プログラムはその時点で停止し、指定した"システムに予期せぬエラーが発生しました"というメッセージが表示されます。

基本構造はthrow 例外オブジェクトという形になります。Exceptionは「何か問題が起きました」という一般的なエラーを表すクラスです。カッコの中には、開発者やログを確認する人が「なぜエラーが起きたのか」を一目で理解できるような具体的なメッセージを記述するのが、良いプログラムを書くためのコツです。

たとえば、「入力された値が空だった場合」や「対象のデータが見つからなかった場合」など、特定の条件を満たさないときにこのthrowを使って処理を中断させ、安全にエラーを通知する仕組みを作ることができます。

3. Kotlinでの例外処理：基本的な使い方（try-catchとthrow）

3. Kotlinでの例外処理：基本的な使い方（try-catchとthrow）

プログラムを実行していると、入力ミスなどの予期せぬ事態で「エラー」が発生することがあります。Kotlinでは、このエラーを**「例外（Exception）」**と呼びます。 例外が発生した際に、プログラムを強制終了させずに「適切に処理する」ための仕組みが**try-catch**構文です。

例外を発生させる（throw）と捕まえる（try-catch）

まずは、簡単な「年齢チェック」のプログラムを例に見てみましょう。 例えば、年齢を入力する欄に「-5歳」のようなありえない数値が入ってきた場合、プログラム側から「それはおかしいですよ！」と警告を出す（投げ出す）のがthrowの役割です。

// 1. 例外を発生させる関数（チェック機能）
fun checkAge(age: Int) {
    if (age < 0) {
        // 「不正な引数です」という例外をわざと発生させる
        throw IllegalArgumentException("年齢にマイナスの値は入力できません。")
    }
    println("入力された年齢は $age 歳です。")
}

fun main() {
    try {
        // 2. 実行したい処理（エラーが起きるかもしれない場所）
        checkAge(-5) 
    } catch (e: IllegalArgumentException) {
        // 3. 例外が発生した時の対策（リカバリー処理）
        println("【入力エラー】${e.message}")
    } finally {
        // 4. エラーの有無に関わらず最後に必ず実行される（任意）
        println("チェック処理が完了しました。")
    }
}

実行結果の確認

【入力エラー】年齢にマイナスの値は入力できません。
チェック処理が完了しました。

このサンプルでは、checkAge(-5)が実行された瞬間にIllegalArgumentExceptionが投げられます。 しかし、それをtry-catchブロックで囲んでいるため、画面にエラーメッセージを表示して、プログラムを安全に継続させることができています。

初心者の方は、まず**「エラーが起きそうな場所をtryで囲み、起きた後の対処法をcatchに書く」**という基本の流れをマスターしましょう。

4. throw文とカスタム例外

4. throw文とカスタム例外

Kotlinでは独自の例外クラスを作ってthrowすることもできます。

class InvalidScoreException(message: String) : Exception(message)

fun checkScore(score: Int) {
    if (score !in 0..100) {
        throw InvalidScoreException("スコアは0から100の間でなければなりません")
    }
    println("スコアは $score 点です")
}

fun main() {
    try {
        checkScore(120)
    } catch (e: InvalidScoreException) {
        println("カスタム例外: ${e.message}")
    }
}

カスタム例外: スコアは0から100の間でなければなりません

5. throwとreturnの違い

5. throwとreturnの違い

returnは関数の処理を終了して呼び出し元に戻りますが、throwは例外を発生させて通常の処理の流れを完全に中断します。throwを実行すると、現在の関数だけでなく、呼び出し元まで影響が及びます。

6. Kotlinでよく使う例外クラス

6. Kotlinでよく使う例外クラス

• IllegalArgumentException：引数が不正なとき
• IllegalStateException：オブジェクトの状態が不正なとき
• IOException：入出力エラーが発生したとき
• NullPointerException：nullを不正に参照したとき

これらの例外はKotlin/Javaで広く使われるため、状況に応じて選びましょう。

7. 初心者が覚えておきたいポイント

7. 初心者が覚えておきたいポイント

• throw文は意図的に例外を発生させるための命令
• 例外は必ずExceptionやそのサブクラスのインスタンス
• throwを使うと処理が途中で終了し、例外が呼び出し元に伝わる
• カスタム例外でエラー内容をわかりやすくできる