カテゴリ: Kotlin 更新日: 2025/09/10

Kotlinの例外メッセージを取得する方法をやさしく解説!初心者でもわかるmessageプロパティの使い方

Kotlinの例外メッセージを取得する方法(messageプロパティ)
Kotlinの例外メッセージを取得する方法(messageプロパティ)

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

生徒

「Kotlinでエラーが起きたときに、その原因を文字で見ることってできますか?」

先生

「はい、できますよ。Kotlinではエラーが発生したときにmessageプロパティを使うことで、原因となったメッセージを文字で取得できます。」

生徒

「そのmessageってどうやって使うんですか?」

先生

「それでは、Kotlinでの例外メッセージの取得方法を基本から見ていきましょう!」

1. Kotlinの例外とは?初心者向けにやさしく解説

1. Kotlinの例外とは?初心者向けにやさしく解説
1. Kotlinの例外とは?初心者向けにやさしく解説

Kotlin(コトリン)で「例外(れいがい)」とは、プログラムを動かしているときに思わぬエラーが発生したことを知らせる仕組みです。

たとえば、ゼロで割り算をしようとしたときや、存在しないファイルを開こうとしたときに「例外」が発生します。

このとき、プログラムはエラー内容をException(エクセプション)という特別なオブジェクトで管理します。

2. messageプロパティとは?どんな時に使うの?

2. messageプロパティとは?どんな時に使うの?
2. messageプロパティとは?どんな時に使うの?

messageプロパティは、Kotlinの例外(Exception)クラスが持っている情報のひとつで、エラーが発生した理由を文字として表すために使います。

たとえば、「数値がマイナスになってはいけません」といった説明がmessageに入っていると、エラーの原因がすぐにわかります。

初心者にとっても、エラー内容を把握するためにとても役立つ機能です。

3. Kotlinでmessageを使ってエラーメッセージを表示する基本

3. Kotlinでmessageを使ってエラーメッセージを表示する基本
3. Kotlinでmessageを使ってエラーメッセージを表示する基本

では、実際にmessageプロパティを使って、エラーの内容を取得するKotlinコードを見てみましょう。


fun main() {
    try {
        val number = 10 / 0
        println("計算結果:$number")
    } catch (e: ArithmeticException) {
        println("エラー内容: ${e.message}")
    }
}

実行結果:


エラー内容: / by zero

このように、ゼロで割り算をしようとしたときにArithmeticException(算術エラー)が発生し、その説明として/ by zeroというメッセージが表示されます。

4. カスタム例外でもmessageを使ってみよう

4. カスタム例外でもmessageを使ってみよう
4. カスタム例外でもmessageを使ってみよう

Kotlinでは、自分で例外を定義すること(カスタム例外)もできます。

その場合でも、Exceptionクラスを継承していれば、messageプロパティを使ってエラーの内容を取得できます。


class MyCustomException(message: String) : Exception(message)

fun checkInput(input: String) {
    if (input.isBlank()) {
        throw MyCustomException("入力が空です")
    }
    println("入力された文字列:$input")
}

fun main() {
    try {
        checkInput("")
    } catch (e: MyCustomException) {
        println("カスタムエラー: ${e.message}")
    }
}

実行結果:


カスタムエラー: 入力が空です

このように、カスタム例外を作ってもmessageでメッセージを取得できるため、処理の流れがわかりやすくなります。

5. 実行時エラーとメッセージの関係を理解しよう

5. 実行時エラーとメッセージの関係を理解しよう
5. 実行時エラーとメッセージの関係を理解しよう

エラーが起きたときに、ただ止まるだけではなく、「何が起きたか」「なぜ起きたか」を教えてくれるのがこのmessageプロパティです。

プログラムを作っていくと、たとえ小さなアプリでも、入力ミスや計算ミスなどでエラーが起こることがあります。

そのとき、画面に表示されるエラーメッセージを見て対処することで、ミスにすばやく気づけます。

このように、messageをうまく使えば、プログラムの信頼性も向上します。

6. エラー処理におけるメッセージの活用法

6. エラー処理におけるメッセージの活用法
6. エラー処理におけるメッセージの活用法

実際のアプリ開発やゲーム制作、簡単なツールなどでも、messageを活用することでエラーの原因をログとして残したり、画面にわかりやすく表示したりできます。

特に初心者が練習する際には、「なんでこのコードで失敗するの?」と悩むことが多いですが、messageを使えばヒントが得られます。

以下のように、ユーザー向けにやさしい説明も追加できます:


try {
    val data = listOf(1, 2, 3)
    println(data[5])
} catch (e: IndexOutOfBoundsException) {
    println("配列の範囲外アクセスです: ${e.message}")
}

実行結果:


配列の範囲外アクセスです: Index 5 out of bounds for length 3

このように、メッセージと一緒に日本語で補足をつけると、ユーザーにもやさしい表示になります。

7. catchの中でログとして出力したり、画面に表示したりしよう

7. catchの中でログとして出力したり、画面に表示したりしよう
7. catchの中でログとして出力したり、画面に表示したりしよう

例外のmessageは、以下のような用途でも使えます:

  • ログファイルに記録する
  • エラー画面に表示する
  • ダイアログやトースト(ポップアップ)で見せる
  • メールやチャット通知で開発者に知らせる

これらをうまく組み合わせると、初心者でもバグの発見や対処がしやすくなるため、学習がスムーズになります。

カテゴリの一覧へ
新着記事
New1
Kotlin
Kotlinのforループの基本!範囲・配列・コレクションの繰り返し処理
New2
Go言語
Go言語のスライスでappend時のメモリの仕組みを理解しよう!初心者でもわかる基礎解説
New3
Go言語
Go言語のスコープとは?ローカル変数・グローバル変数の違いと使い分け
New4
Go言語
Go言語のhttp.ResponseWriterとhttp.Requestの仕組みを理解しよう
人気記事
No.1
Java&Spring記事人気No1
Go言語
Go言語の関数パラメータ!値渡しと参照渡しの違いを理解しよう
No.2
Java&Spring記事人気No2
Swift
Swift Playgroundの使い方を完全解説!初心者に最適な学習環境の始め方
No.3
Java&Spring記事人気No3
Kotlin
Gradleファイル(build.gradle.kts)の書き方と役割をやさしく解説!Kotlin初心者向け完全ガイド
No.4
Java&Spring記事人気No4
Swift
Swiftで数値と文字列を相互変換!NumberFormatterで桁区切りや通貨表示をわかりやすく解説
No.5
Java&Spring記事人気No5
Kotlin
Kotlinの演算子一覧と使い方!算術・比較・論理演算子の基本を解説
No.6
Java&Spring記事人気No6
Swift
Swift開発環境の構築方法を徹底解説!Xcode・Windows・Linux対応
No.7
Java&Spring記事人気No7
Kotlin
Kotlinで画面遷移を実装しよう!初心者でもわかるIntentの使い方完全ガイド
No.8
Java&Spring記事人気No8
Swift
SwiftPMでのバージョン指定と互換性の考え方を初心者向けに徹底解説