apoc.map.mget

详细信息

语法

apoc.map.mget(map, keys [, values, fail ])

描述

返回给定键的 LIST<ANY>。如果某个键不存在且没有提供默认值,该函数将抛出异常。

参数

名称

类型

描述

Map

MAP

要从中提取值列表的映射(Map)。

keys

LIST<STRING>

要提取的键列表。

值 (values)

LIST<ANY>

给定键的默认值。默认值为:[]

fail

布尔值 (BOOLEAN)

如果键不存在且未提供默认值,若此参数为 true 则抛出异常,否则返回 null 值。默认值为:true

返回

LIST<ANY>

使用示例

以下示例返回键 namecountry 的值列表

WITH {name:"Cristiano Ronaldo",country:"Portugal",dob:date("1985-02-05")} AS map
RETURN apoc.map.mget(map, ["name", "country"]) AS output;
结果
输出

["Cristiano Ronaldo", "Portugal"]

以下示例返回键 namecountry 的值列表,以及缺失键 missingKey 的默认值 defaultValue

WITH {name:"Cristiano Ronaldo",country:"Portugal",dob:date("1985-02-05")} AS map
RETURN apoc.map.mget(
    map,
    ["name", "country", "missingKey"],
    [null, null, "defaultValue"]
) AS output;
结果
输出

["Cristiano Ronaldo", "Portugal", "defaultValue"]