辞書

問題を報告する ソースを表示

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 required
検索するキー。
default デフォルトは None です。
キーが見つからない場合に使用するデフォルト値(None ではない)。

items

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 required
キー。
default デフォルトは unbound です。
キーが存在しない場合のデフォルト値。

ポップアイテム

tuple dict.popitem()

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

デフォルトを設定

unknown dict.setdefault(key, default=None)

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

パラメータ

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

update

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

まずオプションの位置引数 pairs で辞書を更新し、次にオプションのキーワード引数を使用して辞書を更新します。位置引数が存在する場合は、dict、反復可能、または None でなければなりません。辞書の場合、その Key-Value ペアがこの辞書に挿入されます。イテラブルの場合は、ペア(または長さ 2 の他のイテラブル)のシーケンスを指定する必要があります。ペアはそれぞれ、挿入する Key-Value ペアとして扱われます。キーワード引数 name=value ごとに、名前と値のペアがこの辞書に挿入されます。

パラメータ

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

values

list dict.values()

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