字典

报告问题 查看源代码

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

有四种方式构建字典:

  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 required
要查找的键。
default 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]

pop

unknown dict.pop(key, default=unbound)

从字典中移除 key 并返回关联的值。如果未找到具有该密钥的条目,请勿移除任何内容并返回指定的 default 值;如果未指定默认值,则失败。

参数

参数 说明
key 必需
键。
default default = unbound
如果该键不存在,则会使用默认值。

popitem

tuple dict.popitem()

从字典中移除并返回第一个 (key, value) 对。popitem 有助于对字典进行破坏性迭代,就像在设置算法中常用的那样。如果字典为空,则 popitem 调用失败。

setdefault

unknown dict.setdefault(key, default=None)

如果字典中包含 key,则返回其值。否则,请插入值为 default 的键并返回 defaultdefault 默认为 None

参数

参数 说明
key 必需
键。
default default = None
如果该键不存在,则为默认值。

update

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

先使用可选的定位参数 pairs 更新字典,然后使用可选的关键字参数更新字典。如果存在位置参数,该参数必须是字典、可迭代对象或无值。如果是字典,则将其键值对插入此字典中。如果是可迭代对象,则必须提供一系列键值对(或其他长度为 2 的可迭代对象),其中每个对象均被视为要插入的键值对。 每个关键字参数 name=value 都会将名称/值对插入此字典。

参数

参数 说明
pairs default = []
字典或条目列表。条目必须是只包含两个元素的元组或列表:键、值。
kwargs 必需
其他条目的字典。

values

list dict.values()

返回值列表:
{2: "a", 4: "b", 1: "c"}.values() == ["a", "b", "c"]