lookup

按键在字典中查找值

自 R2023b 起

全页折叠

语法

value = lookup(d,key)

value = lookup(d,key,FallbackValue=fallback)

说明

value = lookup(d,key) 返回与 dictionary (d) 中的 key 对应的值。如果没有与 key 对应的条目，则 lookup 会抛出错误。

value = lookup(d,key) 等效于 value = d(key)。

示例

value = lookup(d,key,FallbackValue=fallback) 指定在 d 中无法找到 key 时要返回的回退值。

lookup 函数不验证 fallback，除非需要回退值。除非无法找到 key，否则不会抛出错误，即使 lookup 无效也是如此。

示例

全部折叠

在字典中查找值

打开实时脚本

创建一个包含几个键-值对组的字典。

names = ["Unicycle" "Bicycle" "Tricycle"];
wheels = [1 2 3];
d = dictionary(wheels,names)

d =

  dictionary (double ⟼ string) with 3 entries:

    1 ⟼ "Unicycle"
    2 ⟼ "Bicycle"
    3 ⟼ "Tricycle"

查找一个值。

v = lookup(d,1)

v = 
"Unicycle"

使用备用值在字典中查找值

打开实时脚本

创建一个包含几个键-值对组的字典。

names = ["Unicycle" "Bicycle" "Tricycle"];
wheels = [1 2 3];
d = dictionary(wheels,names)

d =

  dictionary (double ⟼ string) with 3 entries:

    1 ⟼ "Unicycle"
    2 ⟼ "Bicycle"
    3 ⟼ "Tricycle"

如果未找到该值，则使用备用值进行查找。

v = lookup(d,[3,5],FallbackValue="Wheeled Vehicle")

v = 1×2 string
    "Tricycle"    "Wheeled Vehicle"

输入参数

全部折叠

`d` — 字典
`dictionary` 对象

字典，指定为 dictionary 对象。如果 d 未配置，lookup 将引发错误。

`key` — 键集
数组

键集，指定为数组。key 的数据类型必须匹配或可转换为 d 中键的数据类型。

`fallback` — 回退值
标量

回退值，指定为标量，其中包含在无法找到 key 时要返回的值。fallback 的数据类型必须匹配或可转换为 d 中值的数据类型。除非未找到 key，否则不会验证 fallback。

示例: FallbackValue="Wheeled Vehicle"

扩展功能

全部展开

C/C++ 代码生成
使用 MATLAB® Coder™ 生成 C 代码和 C++ 代码。

用法说明和限制：

fallback 值的类型必须与字典中的值的类型相同。
即使字典在代码生成时为常量，代码生成器也不会将该字典视为常量。这意味着 lookup 函数不返回常量。不能将 lookup 函数的输出传递给需要常量输入的函数。不能将 lookup 函数的输出用于需要常量的操作，如对异构元胞数组进行索引。代码生成器也无法对 lookup 函数的输出执行依赖常量的优化，如常量折叠。

有关为 MATLAB^® 字典生成 C/C++ 代码时适用的其他注意事项，请参阅代码生成的字典限制 (MATLAB Coder)。

版本历史记录

在 R2023b 中推出

全部展开

R2024b: 代码生成支持

您可以为字典 lookup 函数生成 C/C++ 代码。

另请参阅