例外処理

例外処理は、プログラム実行中に発生するエラーを適切に処理するための仕組みです。ファイルの読み込み失敗やデータの不正など、実行時に起きうるエラーへの対処が重要です。

1. try / except

例外処理は、プログラム実行中に発生するエラーを適切に処理するための仕組みです。ファイルの読み込み失敗やデータの不正など、実行時に起きうるエラーへの対処が重要です。

try / except / finallyの処理の流れを以下の図に示します。

基本的な構文は以下のとおりです。

try:
    # エラーが発生する可能性のある処理
except 例外型:
    # エラー処理

実際に試してみましょう。main.py に以下の内容を記述して実行してみましょう(config.json は作成しないでください)。このプログラムは、存在しないファイルを読み込もうとしたときのエラーを処理するものです。

try:
    with open("config.json", "r") as f:
        content = f.read()
        print("設定ファイルを読み込みました")
except FileNotFoundError:
    print("エラー: 設定ファイルが見つかりません")

config.json が存在しないため、実行すると以下のように出力されます。

エラー: 設定ファイルが見つかりません

config.json が存在しないため open() で FileNotFoundError が発生し、except ブロックのエラーメッセージが表示されています。try ブロック内の print("設定ファイルを読み込みました") は実行されていません。

2. 複数の例外の処理

異なる種類のエラーに対して、個別の処理を記述できます。基本的な構文は以下のとおりです。

try:
    # 処理
except 例外型1 as e:
    # 例外型1のエラー処理
except 例外型2:
    # 例外型2のエラー処理

実際に試してみましょう。main.py に以下の内容を記述して実行してみましょう。このプログラムは、数値変換と範囲チェックで複数の例外を処理するものです。

def parse_number(value_str):
    try:
        value = int(value_str)
        if value < 0 or value > 100:
            raise ValueError("値は0〜100の範囲で指定してください")
        return value
    except ValueError as e:
        print(f"エラー: {e}")
        return None
    except TypeError:
        print("エラー: 値が指定されていません")
        return None

# 正常なケース
result = parse_number("85")
print(f"値: {result}")  # 値: 85

# 不正な値
result = parse_number("abc")
print(f"値: {result}")  # 値: None

# 範囲外の値
result = parse_number("150")
print(f"値: {result}")

実行すると以下のように出力されます。

値: 85
エラー: invalid literal for int() with base 10: 'abc'
値: None
エラー: 値は0〜100の範囲で指定してください
値: None

"85" は正常に変換され 85 が返ります。"abc" は整数に変換できないため ValueError が発生し、"150" は変換後に範囲チェックで引っかかるため ValueError が発生します。いずれのエラーケースでも None が返されています。

3. finally

finally ブロックは、例外の有無に関わらず必ず実行される処理を記述します。基本的な構文は以下のとおりです。

try:
    # 処理
except 例外型:
    # エラー処理
finally:
    # 必ず実行される処理

実際に試してみましょう。main.py に以下の内容を記述して実行してみましょう(data.txt は作成しないでください)。このプログラムは、ファイル読み込みの成功・失敗に関わらずfinallyブロックが実行されることを確認するものです。

def read_data_file(filepath):
    try:
        with open(filepath, "r") as f:
            lines = f.read().splitlines()
            print(f"{len(lines)} 行のデータを読み込みました")
            return lines
    except FileNotFoundError:
        print(f"エラー: {filepath} が見つかりません")
        return []
    except PermissionError:
        print(f"エラー: {filepath} の読み込み権限がありません")
        return []
    finally:
        print("データファイルの読み込み処理が完了しました")

data = read_data_file("data.txt")
print(f"データ: {data}")

data.txt が存在しないため、実行すると以下のように出力されます。

エラー: data.txt が見つかりません
データファイルの読み込み処理が完了しました
データ: []

data.txt が存在しないため FileNotFoundError の except ブロックが実行され、エラーメッセージが表示されています。その後、finally ブロックの「読み込み処理が完了しました」が例外の発生に関わらず実行されています。戻り値は空リスト [] です。

💡 ポイント
finally はファイルのクローズ処理やログの記録など、成功・失敗に関わらず必ず実行したい処理に使用します。ただし、with 文を使用している場合はファイルのクローズは自動的に行われるため、finally でのクローズ処理は不要です。

4. 主要な組み込み例外

よく使われる例外クラスの一覧です。

例外 説明 発生例
FileNotFoundError ファイルが見つからない open("存在しないファイル")
PermissionError 権限がない 読み取り権限のないファイルを開く
ValueError 不正な値 int("abc")
TypeError 型が不正 "abc" + 123
KeyError 辞書のキーが存在しない dict["存在しないキー"]
IndexError リストの範囲外 list[999]
ConnectionError ネットワーク接続エラー API通信の失敗