このページは Cloud Translation API によって翻訳されました。

辞書

辞書は、結合マッピングまたは辞書を表す組み込み型です。辞書では、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 つの方法があります。

辞書式 {k: v, ...} は、指定された Key-Value エントリを含む新しい辞書を生成し、式に出現する順序で挿入します。いずれかのキー式が同じ値を生成する場合、評価は失敗します。
辞書の理解度 {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}
```
組み込みの dict 関数を呼び出すと、指定したエントリを含む辞書が返されます。この辞書は、name の前に位置引数を引数の順序で挿入します。理解と同様に、重複するキーが許容されます。
共用体式 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 でディクショナリを更新し、次にオプションのキーワード引数を指定してディクショナリを更新します。位置引数が存在する場合は、辞書、反復可能、または None である必要があります。辞書の場合、Key-Value ペアがこの辞書に挿入されます。イテラブルの場合は、ペア（または長さ 2 の他のイテラブル）のシーケンスを提供する必要があります。各ペアは挿入対象の Key-Value ペアとして扱われます。各キーワード引数 name=value によって、名前と値のペアがこの辞書に挿入されます。

パラメータ

パラメータ	説明
`pairs`	デフォルトは `[]` です。ディクショナリまたはエントリのリストです。エントリは、key、value の 2 つの要素を含むタプルまたはリストにする必要があります。
`kwargs`	required 追加エントリの辞書。

values

list dict.values()

値のリストを返します。

{2: "a", 4: "b", 1: "c"}.values() == ["a", "b", "c"]