KotlinのrunCatchingで例外処理をスマートに書く方法【初心者向け完全ガイド】

1. runCatchingとは？

1. runCatchingとは？

Kotlin（コトリン）のrunCatching（ランキャッチング）は、例外が起きるかもしれない処理をスッキリと書ける機能です。

エラーが出る可能性のあるコードをtry-catch（トライキャッチ）で囲むと、コードが長くなりがちですが、runCatchingを使えば、シンプルに例外処理ができます。

例えば、数値を文字列から変換するとき、失敗することがあります。そんなときにrunCatchingを使うと、次のように書けます。

fun main() {
    val result = runCatching {
        "123".toInt()
    }

    println(result)
}

2. runCatchingの基本的な書き方

2. runCatchingの基本的な書き方

runCatchingの使い方はとても簡単です。エラーが起こる可能性のある処理を波かっこ{ }で囲むだけです。

この中でエラー（例外）が起きると、自動的にキャッチしてくれます。そして、成功か失敗かをResultという形で返してくれます。

val result = runCatching {
    // ここにエラーが出るかもしれない処理を書く
}

変数resultには、成功ならSuccess、失敗ならFailureという情報が入ります。

3. 成功と失敗を判定する方法

3. 成功と失敗を判定する方法

runCatchingが返すResultオブジェクトは、isSuccess（成功）やisFailure（失敗）を使って中身をチェックできます。

val result = runCatching {
    "abc".toInt() // 数字に変換できないので失敗する
}

if (result.isSuccess) {
    println("変換に成功しました！")
} else {
    println("変換に失敗しました。")
}

変換に失敗しました。

このように、プログラムの途中でエラーが出るかもしれない場合でも、簡単に分岐できます。

4. 成功時と失敗時に処理を分ける方法

4. 成功時と失敗時に処理を分ける方法

さらにrunCatchingでは、onSuccessとonFailureという関数を使うことで、もっとスマートに書くことができます。

runCatching {
    "456".toInt()
}.onSuccess {
    println("変換成功: $it")
}.onFailure {
    println("エラーが発生しました: ${it.message}")
}

変換成功: 456

処理の成功・失敗でやることが分かれている場合には、これがとても便利です。

5. エラー内容をもっと詳しく知りたいとき

5. エラー内容をもっと詳しく知りたいとき

エラーが発生したとき、その中身（メッセージや原因）を知りたい場合は、exceptionOrNullを使います。

val result = runCatching {
    "Kotlin".toInt()
}

val exception = result.exceptionOrNull()
println(exception?.message)

For input string: "Kotlin"

このようにして、失敗の原因をログに残したり、ユーザーに分かりやすく伝えたりすることができます。

6. ネットワーク通信やファイル操作にも便利！

6. ネットワーク通信やファイル操作にも便利！

runCatchingは、ネットワーク通信やファイル読み書きのように、失敗する可能性のある処理でも大活躍します。

たとえば、ファイルを読み込む処理が失敗することもありますが、runCatchingで安全に処理できます。

import java.io.File

fun main() {
    val result = runCatching {
        File("sample.txt").readText()
    }

    result
        .onSuccess { println("ファイル内容: $it") }
        .onFailure { println("ファイル読み込みに失敗しました: ${it.message}") }
}

このようにして、エラーでアプリが強制終了しないように、安全なプログラムが書けます。

7. runCatchingは初心者にもおすすめ

7. runCatchingは初心者にもおすすめ

runCatchingは難しい構文ではなく、誰でもすぐに使える書き方です。

特にKotlinで初めて例外処理を書くとき、try-catchよりも見た目がスッキリするのでおすすめです。

コードが読みやすくなるだけでなく、安全性も高くなります。エラーが起きたときもアプリが落ちずに処理を続けられるのは、初心者にとって大きな安心材料になります。

Kotlinでエラー処理をもっとスマートにしたいと感じたら、ぜひrunCatchingを活用してみてください。

まとめ

まとめ

KotlinのrunCatchingで学んだ例外処理の考え方

この記事では、Kotlinにおける例外処理の新しい書き方として、runCatchingを中心に解説してきました。 従来のtry-catch構文は、処理内容が増えるほどコードが縦に長くなり、初心者にとっては読みづらく、理解しづらいものでした。 その点、runCatchingは「失敗するかもしれない処理」を一つのまとまりとして扱い、成功と失敗をResultとして返すため、 処理の流れを自然な形で記述できます。 Kotlinらしいシンプルで安全な書き方を学ぶうえで、runCatchingはとても重要な存在だと言えるでしょう。

runCatchingが初心者に向いている理由

runCatchingが初心者におすすめされる理由は、文法がシンプルであることに加え、 エラーが起きる前提でプログラムを考えられる点にあります。 isSuccessやisFailureによる判定、onSuccessとonFailureによる分岐処理は、 「うまくいった場合」と「失敗した場合」を意識しながらコードを書く練習になります。 これはKotlinだけでなく、プログラミング全般においてとても大切な考え方です。 エラーを怖がるのではなく、正しく扱う姿勢を身につけることで、より安定したアプリケーションを作れるようになります。

実務でも役立つrunCatchingの活用場面

runCatchingは、数値変換のような小さな処理だけでなく、 ネットワーク通信やファイル操作、データの読み書きなど、実務で頻繁に使われる場面でも非常に有効です。 アプリ開発では、想定外の入力や通信エラー、ファイルの存在しないケースなどが必ず発生します。 そうした場面でrunCatchingを使えば、アプリが突然終了することを防ぎ、 ユーザーにとっても開発者にとっても安心できる設計が可能になります。 Kotlinで安全なコードを書く第一歩として、runCatchingを習慣的に使うことは大きな意味があります。

まとめとしてのサンプルプログラム

fun main() {
    val result = runCatching {
        "789".toInt()
    }

    result
        .onSuccess {
            println("数値変換に成功しました: $it")
        }
        .onFailure {
            println("数値変換に失敗しました: ${it.message}")
        }
}

このようにrunCatchingを使うことで、例外処理を一箇所にまとめながら、 成功時と失敗時の処理を分かりやすく書くことができます。 Kotlinの文法に慣れてきたら、ぜひ自分のコードでも積極的に取り入れてみてください。