Python辞書の使い方入門|dictの作成・取得・追加・削除を実行例で解説

プログラミング

Python辞書の使い方入門|dictの作成・取得・追加・削除を実行例で解説

「Pythonの辞書(dict)は何に使うのか分からない」「値を取り出そうとしたらKeyErrorで止まってしまった」という悩みを持つ方は多いです。

この記事では、Python 辞書 使い方を、Python辞書型の初心者の方向けに順を追って解説します。辞書の作成、キーと値の取得、追加・更新・削除、ループ処理といった基本から、コピー・ソート・結合・JSON連携などの応用まで、コードと実行結果をセットで紹介します。

最初に要点を3つにまとめます。

  • 辞書は「キー」で値を引くデータ構造で、名前やIDで情報を管理したいときに向いています
  • キーが無いかもしれない場面では[]ではなくget()を使うとエラーを防げます
  • 辞書の結合はPython 3.9以降なら|演算子が最も簡潔に書けます

※サンプルコードはPython 3.9以降を前提にしています。

1. Python辞書(dict)の使い方の基本:辞書とは?

キーと値のペアでデータを管理する

辞書は「キー」と「値」を対応づけて保存するデータ構造です。波括弧{}の中にキー: 値をカンマ区切りで並べます。

user = {'name': '山田', 'age': 28, 'city': '東京'}
print(user['name'])
# 実行結果: 山田

辞書の特徴として、paizaラーニングの解説では「同じキーは重複できないが、値は重複可能」「キーを指定することで高速な検索や更新が可能」「Python 3.7以降はデータの順序が保持される」と整理されています。

リストとの違い

リストは「0番目、1番目…」という位置(インデックス)で値を取り出します。一方、辞書は「'name'」のような名前(キー)で値を取り出します。

比較項目 リスト(list) 辞書(dict)
値の取り出し方 インデックス(a[0]) キー(d['name'])
作成時の記号 角括弧[] 波括弧{}
重複 値の重複可 キーは重複不可、値は重複可
向いている用途 順番に並んだデータ 名前・IDで引くデータ
リストインデックスで取得
・ages=['山田','太郎']
・ages[0]で最初の値
・何番目か覚える必要
辞書キーで取得
・ages={'山田':28}
・ages['山田']で直接参照
・名前で検索できる
リストと辞書の値取得方法

たとえば社員100人の年齢をリストで持つと「何番目が誰か」を別に覚える必要がありますが、辞書ならages['山田']のように直接取り出せます。

キーに使えるデータ型

キーには、文字列・数値・タプルなど変更できない(イミュータブルな)データしか使えません。リストや辞書はキーにできません(東京大学のPythonプログラミング入門)。値のほうは、数値・文字列・リスト・辞書など何でも入れられます。

また、同じキーを2回書くと後から書いた値で上書きされます。

d = {'key1': 1, 'key1': 2}
print(d)
# 実行結果: {'key1': 2}

2. 辞書の作成とキー・値の取得方法

{}とdict()で辞書を作る

辞書の作り方は主に2種類です。

# 波括弧で作成
scores = {'国語': 80, '数学': 92}

# dict()関数で作成(キーワード引数)
scores2 = dict(国語=80, 数学=92)

# タプルのリストから作成
scores3 = dict([('国語', 80), ('数学', 92)])

# 空の辞書
empty = {}   # または dict()
print(scores == scores2 == scores3)
# 実行結果: True

なお、dict()のキーワード引数では、ifなどの予約語や数値をキーにできないという制約があります。数値キーを使いたい場合は{}で書きましょう。

[ ]で値を取得する(KeyErrorに注意)

Pythonでキーから値を取得する最も基本的な方法は辞書[キー]です。ただし、存在しないキーを指定するとKeyErrorが発生し、プログラムが停止します。

user = {'name': '山田'}
print(user['age'])
# 実行結果: KeyError: 'age'

get()で安全に値を取得する

get()メソッドは、キーが無いときにエラーではなくNoneを返します。第2引数でデフォルト値も指定できます。

user = {'name': '山田'}
print(user.get('age'))
# 実行結果: None
print(user.get('age', 0))
# 実行結果: 0
確実user['age']
・キーが無いと KeyError
・プログラム停止
・バグに気づきやすい
安全user.get('age',0)
・キーが無いと None
・デフォルト値設定
・プログラム継続できる
[] と get() の使い分け

coddy.techの解説では、「キーが絶対に存在するはず」のときは[]、「キーが無いこともある」のが正常なときはget()という使い分けが紹介されています。[]はバグに早く気づける、get()は止まらない、とそれぞれ利点があるわけです。

3. 辞書に要素を追加・更新・削除する方法

代入で追加・更新する

新しいキーに代入すると追加、既存のキーに代入すると更新になります。

user = {'name': '山田'}
user['age'] = 28        # 追加
user['name'] = '佐藤'   # 更新
print(user)
# 実行結果: {'name': '佐藤', 'age': 28}

setdefault()とupdate()

setdefault()は、キーが無ければ登録して値を返し、既にあれば何もせず既存の値を返します。

count = {'りんご': 3}
count.setdefault('みかん', 0)
count.setdefault('りんご', 0)   # 既存なので無視される
print(count)
# 実行結果: {'りんご': 3, 'みかん': 0}

update()は複数の要素をまとめて追加・更新します。同じキーは引数側の値で上書きされます。

count.update({'りんご': 5, 'ぶどう': 2})
print(count)
# 実行結果: {'りんご': 5, 'みかん': 0, 'ぶどう': 2}

del・pop()・popitem()・clear()で削除する

削除方法は目的別に4つあります。

d = {'a': 1, 'b': 2, 'c': 3, 'd': 4}

del d['a']            # 指定キーを削除
v = d.pop('b')        # 削除して値を受け取る
print(v)
# 実行結果: 2
print(d.pop('z', None))  # 無いキーでもエラーにしない
# 実行結果: None

item = d.popitem()    # 最後に追加された要素を削除
print(item)
# 実行結果: ('d', 4)

d.clear()             # 全要素を削除
print(d)
# 実行結果: {}

値が不要ならdel、削除した値を使いたいならpop()と覚えておくと迷いません。

4. 辞書の存在確認とループ処理

in演算子でキーの存在を確認する

inで調べられるのはキーです。値を確認したいときはvalues()を使います。

user = {'name': 'Rosa', 'age': 30}
print('name' in user)            # 実行結果: True
print('Rosa' in user)            # 実行結果: False(値なので)
print('Rosa' in user.values())   # 実行結果: True

要素数はlen(user)で取得できます(この例では2)。

keys()・values()・items()の違い

メソッド 取り出せるもの 例の結果
keys() キーの一覧 dict_keys(['name', 'age'])
values() 値の一覧 dict_values(['Rosa', 30])
items() (キー, 値)のペア dict_items([('name', 'Rosa'), ('age', 30)])

for文でキーと値を同時に取り出す

実務で最もよく使うのはitems()です。

scores = {'国語': 80, '数学': 92, '英語': 75}
for subject, score in scores.items():
    print(f'{subject}: {score}点')
# 実行結果:
# 国語: 80点
# 数学: 92点
# 英語: 75点

for key in scores:と書けばキーだけ、for v in scores.values():と書けば値だけを順に取り出せます。

5. 辞書の応用テクニック(コピー・ソート・内包表記・結合)

copy()とdeepcopy()の違い

b = aと書くだけでは同じ辞書を2つの名前で指しているだけで、bを変えるとaも変わります。別物にするにはコピーが必要です。

import copy

a = {'tags': ['python', 'dict']}
shallow = a.copy()          # 浅いコピー
deep = copy.deepcopy(a)     # 深いコピー

a['tags'].append('json')
print(shallow['tags'])
# 実行結果: ['python', 'dict', 'json'](中のリストは共有)
print(deep['tags'])
# 実行結果: ['python', 'dict'](完全に独立)

値にリストや辞書が入っている場合はdeepcopy()を使うのが安全です。

sorted()でソートし、内包表記で変換する

辞書は挿入順を保つため、「ソート」とは並べ替えた順で新しい辞書を作ることを意味します。

scores = {'国語': 80, '数学': 92, '英語': 75}

# 値の大きい順に並べ替え
ranked = dict(sorted(scores.items(), key=lambda x: x[1], reverse=True))
print(ranked)
# 実行結果: {'数学': 92, '国語': 80, '英語': 75}

# 辞書内包表記:80点以上だけ抽出
passed = {k: v for k, v in scores.items() if v >= 80}
print(passed)
# 実行結果: {'国語': 80, '数学': 92}

辞書内包表記は「条件で絞り込む」「値をまとめて変換する」場面で、for文の数行を1行にできます。

辞書同士を結合する(update / ** / |)

方法 元の辞書 対応バージョン
a.update(b) aを書き換える 全バージョン
{**a, **b} 新しい辞書を作る Python 3.5以降
a \| b 新しい辞書を作る Python 3.9以降
default = {'theme': 'light', 'lang': 'ja'}
user_conf = {'theme': 'dark'}
print(default | user_conf)
# 実行結果: {'theme': 'dark', 'lang': 'ja'}

いずれも同じキーは右側(後ろ)の値が優先されます。「初期設定をユーザー設定で上書きする」処理にぴったりです。

6. ネスト構造・JSON連携とよくあるエラー

辞書の中に辞書・リストを入れる

値には辞書やリストも入れられるため、複雑なデータも表現できます。

users = {
    'u001': {'name': '山田', 'skills': ['Python', 'SQL']},
    'u002': {'name': '佐藤', 'skills': ['Java']},
}
print(users['u001']['skills'][0])
# 実行結果: Python
print(users.get('u003', {}).get('name', '不明'))
# 実行結果: 不明
users = {
  u001: {name: "山田", skills: […]},
  u002: {name: "佐藤", skills: […]}
}

get()をつなげると、途中のキーが無くてもエラーになりません。

JSONデータとの関係

Web APIのレスポンスや設定ファイルで使われるJSONは、辞書とほぼ同じ形をしています。標準ライブラリのjsonで相互変換できます。

import json

text = '{"name": "山田", "age": 28}'
data = json.loads(text)          # JSON文字列 → 辞書
print(data['name'])
# 実行結果: 山田
print(json.dumps(data, ensure_ascii=False))  # 辞書 → JSON文字列
# 実行結果: {"name": "山田", "age": 28}

辞書を使いこなせると、API連携やデータ処理のコードが一気に書きやすくなります。

よくあるエラーと対処法

Q. KeyErrorが出ます。
A. 存在しないキーを[]で指定しています。get()を使うか、if 'key' in d:で事前に確認しましょう。

Q. TypeError: unhashable type: 'list'が出ます。
A. リストをキーにしています。リストは変更可能なためキーにできません。tuple()でタプルに変換すれば使えます。

d = {tuple([1, 2]): '座標'}
print(d[(1, 2)])
# 実行結果: 座標

Q. 辞書の順番は保証されますか?
A. Python 3.7以降は、要素を追加した順番が保持される仕様です。

まとめ

Pythonの辞書(dict)の使い方を、基本から応用まで解説しました。

  • 辞書はキーと値のペアで管理し、キーには変更できない型(文字列・数値・タプル)を使う
  • 作成は{}かdict()、取得は[]、キーが無いかもしれないときはget()
  • 追加・更新は代入、まとめて更新はupdate()、削除はdel・pop()・popitem()・clear()
  • ループはitems()でキーと値を同時に取り出すのが定番
  • 応用として、コピーはdeepcopy()、ソートはsorted()、結合はPython 3.9以降なら|演算子が便利
  • JSONとの相互変換で、API連携や設定管理に活用できる

まずは身近なデータ(家計簿の費目と金額、テストの科目と点数など)を辞書にして、取得・追加・ループを実際に試してみてください。手を動かすことで、辞書の便利さがすぐに実感できるはずです。

参考にしたサイト

コメント

タイトルとURLをコピーしました