|| apoc.map.mget - APOC 核心文档 - Neo4j 文档

apoc.map.mget

详情
语法	`apoc.map.mget(map, keys [, values, fail ])`
描述	返回给定键的 `LIST<ANY>`。如果其中一个键不存在，或缺少默认值，此函数将抛出异常。
参数	名称	类型	描述
	`map`	`MAP`	从中提取值列表的映射。
	`keys`	`LIST<STRING>`	要提取的键列表。
	`values`	`LIST<ANY>`	给定键的默认值。默认值是：`[]`。
	`fail`	`BOOLEAN`	如果某个键不存在且未提供默认值，当此参数为 true 时将抛出异常，否则返回 null 值。默认值是：`true`。
返回	`LIST<ANY>`

使用示例

以下返回键 name 和 country 的值列表

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

以下返回键 name 和 country 的值列表，以及缺失键 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"]