Pythonで辞書の値にアクセスする方法｜基本構文とKeyErrorへの対処法

Pythonの辞書（dict）の要素にアクセスするには、おなじみの角括弧 [] を使ってキーを指定します。これにより、キーに対応する値を簡単に取得できます。

基本的な例

以下は最もシンプルなサンプルコードです。

#!/usr/bin/python3

dict = {'Name': 'Zara', 'Age': 7, 'Class': 'First'}
print("dict['Name']: ", dict['Name'])
print("dict['Age']: ", dict['Age'])

実行結果

上記のコードを実行すると、次のような出力が得られます。

dict['Name']: Zara
dict['Age']: 7

このように、dict[キー] の形式で記述するだけで、対応する値を取り出せます。

存在しないキーにアクセスした場合

辞書に登録されていないキーで値を取得しようとすると、KeyError というエラーが発生します。

例

#!/usr/bin/python3

dict = {'Name': 'Zara', 'Age': 7, 'Class': 'First'}
print("dict['Alice']: ", dict['Alice'])

実行結果

上記のコードを実行すると、次のようなエラーが出力されます。

Traceback (most recent call last):
  File "test.py", line 4, in <module>
    print("dict['Alice']: ", dict['Alice'])
KeyError: 'Alice'

KeyError: 'Alice' は、「'Alice' というキーは辞書内に存在しない」ことを意味しています。

エラーを避けるための安全なアクセス方法

存在しないキーへのアクセスによるエラーを防ぎたい場合は、get() メソッドを使うのが便利です。get() は、キーが存在しない場合に None を返すため、プログラムが途中で停止しません。また、第2引数でデフォルト値を指定することも可能です。

print(dict.get('Alice'))             # None を返す
print(dict.get('Alice', '未登録'))    # デフォルト値「未登録」を返す

さらに、in 演算子を使えば、キーが辞書に存在するかどうかを事前に確認することもできます。

if 'Alice' in dict:
    print("dict['Alice']: ", dict['Alice'])
else:
    print("'Alice' は辞書に存在しません")

用途に応じて角括弧・get()・in を使い分けることで、安全かつ読みやすいコードを書くことができます。