語音輸入

回報問題 查看來源 Nightly

字典是一種內建類型，代表關聯對應或字典。字典支援使用 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")]

建立字典的方式有四種：

  1. 字典運算式 {k: v, ...} 會產生含有指定鍵/值項目的新字典，並依照其在運算式中出現的順序插入。如果任兩個鍵運算式產生相同值，評估作業就會失敗。
  2. 字典理解程度 {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}
  3. 對內建 dict 函式的呼叫會傳回包含指定項目的字典，這個字典會依照引數順序插入，在命名之前的位置引數。就像理解來說，可以有重複的鍵。
  4. 聯集運算式 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)。

items

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 必要
金鑰。
default 如果鍵不存在，則預設值為 unbound
。

爆米花

tuple dict.popitem()

從字典中移除並傳回前 (key, value) 對組。popitem 適用於破壞性疊代的字典，就像在集演算法中使用一樣。如果字典沒有任何內容，popitem 呼叫就會失敗。

設定預設值

unknown dict.setdefault(key, default=None)

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

參數

參數 說明
key 必要
金鑰。
default 如果鍵不存在，則預設值為 None
。

update

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

請先使用選用的位置引數 pairs 更新字典，然後再使用選用的關鍵字引數更新字典。位置引數存在時，必須為字典、疊代引數或無。如果是字典，則系統會將鍵/值組合插入這個字典。如果是可疊代項目，則必須提供一對 (或其他長度為 2 的可疊代項目) 序列，每個組合都會視為要插入的鍵/值組合。每個關鍵字引數 name=value 都會將名稱/值組合插入這個字典。

參數

參數 說明
pairs 預設值為 []
可以是字典或項目清單。項目必須為元組或僅包含兩個元素：鍵、值。
kwargs 必要
其他項目字典。

值

list dict.values()

傳回值清單：
{2: "a", 4: "b", 1: "c"}.values() == ["a", "b", "c"]