dictionary
说明
字典对于在较大数据集中快速查找值来说很有用。字典是将数据存储为值的映射,这些值可以使用对应的唯一键来访问。每对键和值构成一个条目。
创建对象
描述
使用指定的键和值创建一个字典。生成的字典 d
= dictionary(keys
,values
)d
是一个 1×1 标量对象。如果将多个值赋给同一个键,则只赋这些值中的最后一个值。对现有键的新赋值会覆盖该条目的值。
keys
和 values
的大小必须相同,除非 values
是标量,其中 keys
的每个元素成为 values
的一个键。当键和值是数组时,条目的数量等于键-值对组的数量。
字典的类型是根据其条目确定的。字典中的所有键和所有值必须分别具有相同的数据类型,或能够转换为配置的数据类型。如果新条目的某些部分的数据类型不同于已配置的数据类型,则 MATLAB® 会尝试转换。键和值的数据类型不必相同。字符行向量在被赋值为键或值时会转换为字符串标量。
如果不同类型的值包含在一个元胞数组中,则您可以将它们添加到字典中。在对使用元胞作为值的字典执行查找时,将返回元胞数组。使用花括号 ({}
) 而不是圆括号可以直接访问元胞数组的内容。 (自 R2023a 起)
使用指定的键-值对组创建一个字典。如果指定了同一个键的多个实例,则只对最后一个键-值对组赋值。d
= dictionary(k1,v1,...,kN,vN
)
创建一个没有键或值的未配置字典。 d
= dictionary
在创建没有输入的字典时,该字典是未配置的字典,并且没有类型。向未配置的字典中添加条目会为键和值分别指定数据类型。
输入参量
用途
描述
使用 dictionary
创建字典 d
。然后,您可以使用以下任何语法在特定查询点处计算或更改 d
:
valueOut = d(keys)
查找对应于 keys
的值。
d(keys) = newValues
将 newValues
的元素赋给由 keys
的对应值指定的条目。如果字典中不存在指定的键,则会添加一个新条目。如果将多个值赋给同一个键,则只赋这些值中的最后一个值。对现有键的新赋值会覆盖该条目的值。
d(keys) = []
从字典中删除与 keys
关联的条目。
valueOut = d{keys}
查找与 keys
关联的值并返回元胞的内容。如果 keys
是数组,则返回对应值的以逗号分隔的列表。如果字典的值配置为不同于元胞的数据类型,则会引发错误。
d{keys} = newValues
将包含 newValues
的元素的元胞赋给由对应键值指定的条目。如果字典的值配置为元胞以外的数据类型,则会引发错误。
对象函数
configureDictionary | Create dictionary with specified key and value types |
insert | Add entries to a dictionary |
lookup | Find value in dictionary by key |
remove | Remove dictionary entries |
entries | Key-value pairs of dictionary |
keys | 字典的键 |
values | Values of dictionary |
types | Types of dictionary keys and values |
numEntries | Number of key-value pairs in dictionary |
isConfigured | Determine if dictionary has types assigned to keys and values |
isKey | Determine if dictionary contains key |
示例
版本历史记录
在 R2022b 中推出另请参阅
configureDictionary
| insert
| lookup
| remove
| entries
| keys
| values
| types
| numEntries
| isConfigured
| isKey
| keyHash
| keyMatch