語音輸入

回報問題 查看來源 Nightly · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

dict 是內建型別,代表關聯對應或字典。字典支援使用 d[k] 建立索引,以及使用 k in d 測試鍵成員資格;這兩項作業都需耗費固定時間。未凍結的字典可變動,可透過指派給 d[k] 或呼叫特定方法來更新。字典可疊代;疊代會產生插入順序的金鑰序列。更新現有鍵的相關值不會影響疊代順序,但移除鍵再重新插入則會影響。

d = {0: "x", 2: "z", 1: "y"}
[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, "y"), (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)。

項目

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
, 如果缺少鍵,則為預設值。

popitem

tuple dict.popitem()

從字典中移除並傳回第一個 (key, value) 配對。popitem 可用於以破壞性方式疊代處理字典,這在集合演算法中很常見。如果字典為空白,popitem 呼叫就會失敗。

setdefault

unknown dict.setdefault(key, default=None)

如果 key 位於字典中,則傳回其值。如果沒有,請插入值為 default 的鍵,然後傳回 defaultdefault 預設為 None

參數

參數 說明
key 必要
金鑰。
default 預設值為 None
, 如果缺少鍵,則為預設值。

update

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

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

參數

參數 說明
pairs 預設值為 []
。可以是字典或項目清單。項目必須是元組或清單,且正好有兩個元素:鍵和值。
kwargs 必要
其他項目的字典。

list dict.values()

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