HOWTO · Python

Python の辞書の配列またはリスト

このチュートリアルでは、Python で辞書の配列を作成する方法を示します

このページの内容

複数の辞書をまとめるときは、通常 Python のリストを使います。リストの各要素に、キーと値の組で構成されるレコードを格納できます。「辞書の配列」と呼ばれることもありますが、Python のリストと専用の配列型は別のものです。以下では、リストの作成、レコードや値の参照、レコードの追加、値の更新方法を紹介します。

Python で辞書のリストを作成する

リストリテラルの中に、それぞれの辞書を要素として記述します。各リテラルは別々の辞書を作るため、レコードごとに異なるキーを使うことも、一部のキーを共通にすることもできます。records のような内容が分かる変数名を使いましょう。list は Python の組み込み機能の名前です。

次の例を実行します。

このセクションのコードと表示されるラベルや出力は英語のままです。

records = [
    {"name": "Ada", "role": "engineer"},
    {"name": "Lin", "role": "designer"},
]
print(records)
[{'name': 'Ada', 'role': 'engineer'}, {'name': 'Lin', 'role': 'designer'}]

インデックスとキーで辞書や値を参照する

Python のリストのインデックスは 0 から始まるため、インデックス 1 で2番目の辞書を選択できます。フィールドの値を読むには、まずリストのインデックスで辞書を選び、次に角括弧内のキーを指定します。1つの式の中で、リストと辞書を順に参照します。

このセクションのコードと表示されるラベルや出力は英語のままです。

records = [
    {"name": "Ada", "role": "engineer"},
    {"name": "Lin", "role": "designer"},
]
second_record = records[1]
role = records[1]["role"]
print(second_record)
print(role)
{'name': 'Lin', 'role': 'designer'}
designer

角括弧で値を参照するには、選択した辞書にそのキーが存在している必要があります。キーがない場合もあるなら、record.get("role") を使うと、既定では None が返ります。または、record.get("role", "unknown") のように代替値を指定できます。

辞書をリストに追加する

append() を呼び出すと、既存のリストの末尾に辞書を1つ追加できます。リスト自体がその場で変更され、新しいリストが作られるわけではありません。

このセクションのコードと表示されるラベルや出力は英語のままです。

records = [{"name": "Ada", "role": "engineer"}]
records.append({"name": "Lin", "role": "designer"})
print(records)
[{'name': 'Ada', 'role': 'engineer'}, {'name': 'Lin', 'role': 'designer'}]

リスト内の辞書を更新する

インデックスでレコードを選び、キーに値を代入して変更します。まだ存在しないキーに代入すると、そのキーが追加されます。この構文は、既存フィールドの値の置き換えと、新しいフィールドの追加のどちらにも使えます。

このセクションのコードと表示されるラベルや出力は英語のままです。

records = [{"name": "Ada", "role": "engineer"}]
records[0]["role"] = "lead engineer"
records[0]["team"] = "platform"
print(records)
[{'name': 'Ada', 'role': 'lead engineer', 'team': 'platform'}]

リスト内包表記で辞書のリストを作成する

各レコードが同じ形式なら、リスト内包表記を使うと簡潔に書けます。式に辞書リテラルを置くと、反復のたびに別の辞書が作られます。たとえば、同じフィールドを持つ辞書を4つ作成できます。

このセクションのコードと表示されるラベルや出力は英語のままです。

records = [{"active": True, "score": 0} for _ in range(4)]
print(records)
[{'active': True, 'score': 0}, {'active': True, 'score': 0}, {'active': True, 'score': 0}, {'active': True, 'score': 0}]

空の辞書を複数作る場合は、反復ごとに dict() を呼び出します。

records = [dict() for _ in range(3)]
print(records)
[{}, {}, {}]

内包表記では、反復可能オブジェクトの値からフィールドの値を作ることもできます。

records = [{"id": number, "label": f"item-{number}"} for number in range(3)]
print(records)
[{'id': 0, 'label': 'item-0'}, {'id': 1, 'label': 'item-1'}, {'id': 2, 'label': 'item-2'}]

変更可能な辞書を1つ含むリストを乗算して、レコードを複数作る方法は避けてください。たとえば [{}] * 3 は同じ辞書への参照を繰り返すため、1つの要素を変更すると、3つの位置すべてから見える内容が変わります。{} を使う内包表記なら、反復ごとに新しい辞書が作られます。

ループで辞書を作成する

辞書の作成に複数の手順が必要な場合や、条件に応じてフィールドを追加する場合は、ループを使います。反復のたびに新しい辞書を作り、それをリストに追加します。

このセクションのコードと表示されるラベルや出力は英語のままです。

records = []
for number in range(3):
    record = {"id": number, "score": number * 10}
    records.append(record)

for record in records:
    print(record)
{'id': 0, 'score': 0}
{'id': 1, 'score': 10}
{'id': 2, 'score': 20}

ここでは、ループの各反復で現在の number を使って1つのレコードを作り、次の反復に進む前に append() でその辞書をリストに格納しています。

dict() コンストラクターで辞書を作成する

dict() コンストラクターは、引数なしで空の辞書を作成するか、キーワードフィールドから辞書を作成します。キーワード名が文字列のキーになります。

このセクションのコードと表示されるラベルや出力は英語のままです。

blank_record = dict()
person = dict(name="John", age=30, city="New York")
print(blank_record)
print(person)
{}
{'name': 'John', 'age': 30, 'city': 'New York'}

個別に dict() を呼び出せば、辞書を複数作ってリストに格納できます。

records = [
    dict(name="Ada", role="engineer"),
    dict(name="Lin", role="designer"),
]
for record in records:
    print(record)
{'name': 'Ada', 'role': 'engineer'}
{'name': 'Lin', 'role': 'designer'}

辞書のキーにはハッシュ可能な値を使う必要があります。文字列や数値のほか、ハッシュ可能な値だけで構成されたタプルも使えますが、リストのような変更可能な型はキーにできません。辞書内で各キーは1回だけ登場します。同じキーを含むキーと値の組から辞書を作る場合、後の値が前の値を置き換えます。dict() にキーワード引数を渡す場合、同じキーワードを1回の呼び出しで複数回指定することはできません。入力に重複キーが含まれる可能性があるときは、マッピングまたはペアの列を使います。