語音輸入

回報問題查看原始碼 Nightly · 8.0 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

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")]

建構字典的方法有四種：

字典運算式 {k: v, ...} 會產生新字典，其中包含指定的鍵/值項目，並依照運算式中顯示的順序插入。如果任何兩個鍵運算式產生相同的值，評估作業就會失敗。
字典解釋 {k: v for vars in seq} 會產生新的字典，其中每個鍵/值組合會依循迴疊代順序插入。允許重複值：指定鍵的第一次插入作業會決定其在序列中的位置，而最後一次插入作業會決定其關聯值。
```
{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 函式的呼叫會傳回字典，其中包含指定的項目，並依引數順序插入，其中位置引數會插入在命名引數之前。與 comprehension 一樣，重複的鍵是允許的。
聯集運算式 x | y 會結合兩個現有的字典，產生新的字典。如果兩個字典有共同的鍵 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()

傳回鍵/值元組清單：

{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 The key.
`default`	預設值為 `unbound` ，如果沒有鍵則為預設值。

popitem

tuple dict.popitem()

從字典中移除並傳回第一個 (key, value) 組合。popitem 可用於以破壞性方式逐一處理字典，這類用法經常出現在集合演算法中。如果字典為空白，popitem 呼叫就會失敗。

setdefault

unknown dict.setdefault(key, default=None)

如果字典中含有 key，則傳回其值。如果不是，請插入值為 default 的鍵，並傳回 default。default 預設為 None。

參數

參數	說明
`key`	required The key.
`default`	預設值為 `None` ，如果沒有鍵則為預設值。

update

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

先使用選用的位址引數 pairs 更新字典，再使用選用的關鍵字引數更新字典。如果有位址引數，則必須是字典、可迴圈項目或 None。如果是字典，則會將其鍵/值組合插入這個字典。如果是可枚舉項目，則必須提供一組序列 (或長度為 2 的其他可枚舉項目)，每個項目都會視為要插入的鍵/值組合。每個關鍵字引數 name=value 都會導致名稱/值組合插入這個字典。

參數

參數	說明
`pairs`	預設為 `[]` 。字典或項目清單。項目必須是元組或清單，且只含有兩個元素：鍵和值。
`kwargs`	required Additional 字典項目。

值

list dict.values()

傳回值清單：

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