Python - 辞書の要素を削除する

要素の削除: del()

辞書の要素を削除するには del 関数を使用します。

dict = {'key1': 'value1', 'key2': 'value2'}

del dict['key2']
print(dict)
# {'key1': 'value1'}

存在しないキーを指定すると KeyError 例外が発生します。

dict = {'key1': 'value1', 'key2': 'value2'}

del dict['key3']
# KeyError 'key3'

要素の削除: pop()

pop 関数を使用しても辞書の要素を削除することができます。pop 関数は、引数に指定したキーの要素を取得した上で辞書から削除します。

dict = {'key1': 'value1', 'key2': 'value2'}

item = dict.pop('key2')

print(dict)
# {'key1': 'value1'}
print(item)
# value2

存在しないキーを指定すると KeyError 例外が発生します。

dict = {'key1': 'value1', 'key2': 'value2'}

item = dict.pop('key3')
# KeyError 'key3'

ただし、任意のパラメータを指定した場合、存在しないキーを指定してもエラーとはならずパラメータの値が返ります。

dict = {'key1': 'value1', 'key2': 'value2'}

item = dict.pop('key3', "要素が見つかりませんでした")

print(dict)
# {'key1': 'value1'}
print(item)
# 要素が見つかりませんでした

要素の削除: popitem()

popitem 関数を使用しても辞書の要素を削除することができます。popitem 関数は、辞書に最後に追加された要素をタプルとして取得したあとに要素を辞書から削除します。

dict = {'key1': 'value1', 'key2': 'value2'}

item = dict.popitem()

print(dict)
# {'key1': 'value1'}
print(item)
# ('key2', 'value2')

要素の削除: clear()

clear 関数は、辞書に含まれるすべての要素を削除します。

dict = {'key1': 'value1', 'key2': 'value2'}

dict.clear()
print(dict)
# {}

要素の追加

辞書に key : value のペア（要素）を追加するには、以下のように行います。

dict = {'key1': 'value1', 'key2': 'value2'}

dict['key3'] = 'value3'

print(dict)
# {'key1': 'value1', 'key2': 'value2', 'key3': 'value3'}

すでに存在しているキーの値を上書きしたくない場合は、setdefault 関数を使用します。setdefault 関数は、キーが存在しない場合に限り、新たな要素が追加されます。もしも、すでにキーが存在している場合は何も更新されません。

setdefault 関数では、第一引数に key、第二引数に value を指定します。

dict = {'key1': 'value1', 'key2': 'value2'}

dict.setdefault('key3', 'value3')
print(dict)
# {'key1': 'value1', 'key2': 'value2', 'key3': 'value3'}

dict.setdefault('key1', '123')
print(dict)
# {'key1': 'value1', 'key2': 'value2', 'key3': 'value3'}