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. 基本的な使用例

3. 基本的な使用例

fun checkAge(age: Int) {
    if (age < 0) {
        throw IllegalArgumentException("年齢は0以上でなければなりません")
    }
    println("年齢は $age 歳です")
}

fun main() {
    try {
        checkAge(-5)
    } catch (e: IllegalArgumentException) {
        println("エラーが発生: ${e.message}")
    }
}

エラーが発生: 年齢は0以上でなければなりません

この例では、年齢が負の値だった場合にIllegalArgumentExceptionをthrowしています。

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を使うと処理が途中で終了し、例外が呼び出し元に伝わる
• カスタム例外でエラー内容をわかりやすくできる