辞書

dict は、連想マッピングまたは 辞書を表す組み込み型です。辞書は、d[k] を使用したインデックス作成と、k in d を使用したキー メンバーシップ テストをサポートしています。どちらのオペレーションも一定時間で実行されます。フリーズされていない辞書は変更可能で、d[k] に代入するか、特定のメソッドを呼び出すことで更新できます。辞書は反復可能で、反復処理では挿入順にキーのシーケンスが生成されます。反復処理の順序は、既存のキーに関連付けられた値を更新しても影響を受けませんが、キーを削除して再挿入すると影響を受けます。
d = {0: 0, 2: 2, 1: 1}
[k for k in d]  # [0, 2, 1]
d.pop(2)
d[0], d[2] = "a", "b"
0 in d, "a" in d  # (True, False)
[(k, v) for k, v in d.items()]  # [(0, "a"), (1, 1), (2, "b")]

辞書を作成する方法は 4 つあります。

  1. 辞書式 {k: v, ...} は、指定された Key-Value エントリを含む新しい辞書を生成します。エントリは、式に表示される順序で挿入されます。2 つのキー式が同じ値を生成すると、評価は失敗します。
  2. 辞書内包表記 {k: v for vars in seq} は、各 Key-Value ペアがループ反復順に挿入される新しい辞書を生成します。重複は許可されます。特定のキーの最初の挿入によって、シーケンス内の位置が決まり、最後の挿入によって関連付けられた値が決まります。
    {k: v for k, v in (("a", 0), ("b", 1), ("a", 2))}  # {"a": 2, "b": 1}
    {i: 2*i for i in range(3)}  # {0: 0, 1: 2, 2: 4}
    
  3. 組み込みの dict 関数を呼び出すと、指定されたエントリを含む辞書が返されます。エントリは引数の順序で挿入されます。名前付き引数の前に位置引数が挿入されます。内包表記と同様に、重複するキーは許可されます。
  4. 結合式 x | y は、2 つの既存の辞書を結合して新しい辞書を生成します。2 つの辞書に共通のキー k がある場合、右側の辞書のキーの値(つまり y[k])が優先されます。結合演算子の |= バリアントは、辞書をインプレースで変更します。例:
    d = {"foo": "FOO", "bar": "BAR"} | {"foo": "FOO2", "baz": "BAZ"}
    # d == {"foo": "FOO2", "bar": "BAR", "baz": "BAZ"}
    d = {"a": 1, "b": 2}
    d |= {"b": 3, "c": 4}
    # d == {"a": 1, "b": 3, "c": 4}

メンバー

クリア

None dict.clear()

辞書からすべてのアイテムを削除します。

get

unknown dict.get(key, default=None)

key が辞書にある場合は key の値を返し、それ以外の場合は default を返します。default が指定されていない場合、デフォルトは None になるため、このメソッドでエラーが発生することはありません。

パラメータ

パラメータ 説明
key 必須
検索するキー。
default デフォルトは None
キーが見つからない場合に使用するデフォルト値(None の代わり)。

アイテム

list dict.items()

Key-Value タプルのリストを返します。
{2: "a", 4: "b", 1: "c"}.items() == [(2, "a"), (4, "b"), (1, "c")]

list dict.keys()

キーのリストを返します。
{2: "a", 4: "b", 1: "c"}.keys() == [2, 4, 1]

ポップ

unknown dict.pop(key, default=unbound)

辞書から key を削除し、関連付けられた値を返します。そのキーのエントリが見つからなかった場合は、何も削除せずに、指定された default 値を返します。デフォルト値が指定されていない場合は、代わりに失敗します。

パラメータ

パラメータ 説明
key 必須
キー。
default デフォルトは unbound
キーが存在しない場合のデフォルト値。

popitem

tuple dict.popitem()

辞書から最初の (key, value) ペアを削除して返します。popitem は、セット アルゴリズムでよく使用されるように、辞書を破滅的に反復処理する場合に便利です。辞書が空の場合、popitem 呼び出しは失敗します。

setdefault

unknown dict.setdefault(key, default=None)

key が辞書にある場合は、その値を返します。ない場合は、値が default のキーを挿入して default を返します。default のデフォルトは None です。

パラメータ

パラメータ 説明
key 必須
キー。
default デフォルトは None
キーが存在しない場合のデフォルト値。

update

None dict.update(pairs=[], **kwargs)

まず、オプションの位置引数 pairs で辞書を更新し、次にオプションのキーワード引数で更新します 位置引数が存在する場合は、辞書、反復可能オブジェクト、または None である必要があります 辞書の場合は、その Key-Value ペアがこの辞書に挿入されます。反復可能オブジェクトの場合は、ペアのシーケンス(または長さ 2 の他の反復可能オブジェクト)を提供する必要があります。各ペアは、挿入される Key-Value ペアとして扱われます。 各キーワード引数 name=value により、Name-Value ペアがこの辞書に挿入されます。

パラメータ

パラメータ 説明
pairs デフォルトは []
辞書またはエントリのリスト。エントリは、キーと値の 2 つの要素を持つタプルまたはリストである必要があります。
kwargs 必須
追加のエントリの辞書。

values

list dict.values()

値のリストを返します。
{2: "a", 4: "b", 1: "c"}.values() == ["a", "b", "c"]