Pythonの辞書操作まとめ: 追加/取得/削除をコード例で解説

# 空の辞書の作成方法は2通りあります
a = {}
b = dict()

print(type(a), a)  # {} を使う
print(type(b), b)  # dict() を使う

# 1) リテラルで一度に定義
user = {"name": "Alice", "age": 20}

# 2) キーワード引数 (キーが識別子として有効な場合)
config = dict(debug=True, retry=3)

# 3) (キー, 値)のペア列から生成
pairs = [("x", 1), ("y", 2)]
point = dict(pairs)

# 4) fromkeysでキー集合から同一値を割り当て
#    注意: ミュータブルな値を使うと全キーで共有されるので注意
keys = ["a", "b", "c"]
same_zero = dict.fromkeys(keys, 0)

print(user)
print(config)
print(point)
print(same_zero)

inventory = {"apple": 3}

# 新しいキーの追加
inventory["banana"] = 5

# 既存キーの上書き
inventory["apple"] = 10

print(inventory)

counts = {}

# 'red' が無ければ 0 を入れて、その値を返す
r = counts.setdefault("red", 0)

# 既にある場合は変更しない
counts["red"] = counts["red"] + 1
s = counts.setdefault("red", 999)  # ここでは追加も上書きもしない

print(counts, r, s)

profile = {"name": "Alice"}

# 辞書でまとめて更新
profile.update({"age": 21, "country": "JP"})

# (キー, 値)のシーケンスでもOK
profile.update([("age", 22), ("city", "Tokyo")])

# キーワード引数でもOK (キーが識別子として有効な場合)
profile.update(active=True)

print(profile)

base = {"a": 1, "common": 0}
extra = {"b": 2, "common": 99}

# 新しい辞書を作る (base はそのまま)
merged = base | extra

# 破壊的に更新 (base 自体が書き換わる)
base |= extra

print("merged:", merged)
print("base:", base)
print("extra:", extra)

conf = {"timeout": 10}

print(conf["timeout"])  # 存在するので取得できる

# 存在しないキーは KeyError になる
try:
    print(conf["retries"])
except KeyError as e:
    print("KeyError:", e)

conf = {"timeout": 10}

print(conf.get("timeout"))          # 見つかればその値
print(conf.get("retries"))          # 無ければ None
print(conf.get("retries", 3))       # 無ければ 3 を返す(辞書は変化しない)
print(conf)                         # そのまま

d = {"x": 1, "y": 2}

print("x" in d)     # キー 'x' はある
print(2 in d)       # 値 2 は対象外 (False)
print("z" not in d) # 無いので True

d = {"x": 1, "y": 2, "z": 3}

print(list(d.keys()))    # キー一覧
print(list(d.values()))  # 値一覧
print(list(d.items()))   # (キー, 値)のタプル一覧

# 反復で使う例
for k, v in d.items():
    print(f"{k} => {v}")

d = {"a": 1, "b": 2}

del d["a"]           # 'a' を削除
print(d)

# 無いキーを削除すると KeyError
try:
    del d["c"]
except KeyError as e:
    print("KeyError:", e)

d = {"a": 1, "b": 2}

val = d.pop("a")           # 取り出して削除
print(val, d)

missing = d.pop("c", 0)    # 無ければ 0 を返す(例外なし)
print(missing, d)

d = {}
d["x"] = 1
d["y"] = 2

item = d.popitem()
print("popped:", item)
print("after:", d)

# 空で呼ぶと KeyError
try:
    empty = {}.popitem()
except KeyError as e:
    print("KeyError:", e)

d = {"a": 1, "b": 2}
d.clear()
print(d)

d = {"a": 1}

# 1) 事前に存在確認して del
if "b" in d:
    del d["b"]  # 実行されない
else:
    print("'b' は無いのでスキップ")

# 2) pop にデフォルトを渡す (例外を出さない)
removed = d.pop("b", None)
print("removed:", removed, "dict:", d)

# 3) 例外処理で囲む (存在しないことが稀ならこれが最も速いことも)
try:
    del d["b"]
except KeyError:
    pass  # ログなどの処理に置き換え可能

print(d)