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

先生と生徒の会話形式で理解しよう

生徒

「Kotlinでエラーが出たときの処理って、どう書くのが正解なんでしょうか？ try-catchが多くて読みにくくなります……」

先生

「KotlinではrunCatchingという便利な関数を使うことで、例外処理をもっと簡潔に書くことができますよ。」

生徒

「えっ、runCatching？聞いたことありません！どんな仕組みなんですか？」

先生

「では、runCatchingの基本から一緒に見ていきましょう。」

1. runCatchingとは？

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

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

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


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

    println(result)
}

2. runCatchingの基本的な書き方

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

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


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

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

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

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


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

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


変換に失敗しました。

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

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

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


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


変換成功: 456

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

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

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


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

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


For input string: "Kotlin"

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

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は初心者にもおすすめ

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の文法に慣れてきたら、ぜひ自分のコードでも積極的に取り入れてみてください。

先生と生徒の振り返り会話

生徒「runCatchingを使うと、例外処理がこんなに読みやすくなるんですね。今までtry-catchでごちゃごちゃしていました」

先生「そうですね。Kotlinではコードの読みやすさをとても大切にしています。runCatchingはその考え方を体現した機能です」

生徒「成功と失敗を分けて考えるのが分かりやすかったです。エラーが出ても怖くなくなりました」

先生「それは大きな成長ですね。エラーは避けるものではなく、正しく処理するものです」

生徒「これからはファイル操作や通信処理でもrunCatchingを使ってみます」

先生「ぜひ挑戦してください。Kotlinの例外処理に慣れることで、より安全で信頼できるプログラムが書けるようになりますよ」