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

apoc.map.get

详情
语法	`apoc.map.get(map, key [, value, fail ])`
描述	返回给定键的值。如果给定键不存在或缺少默认值，此函数将抛出异常。
参数	名称	类型	描述
	`map`	`MAP`	从中提取值的映射。
	`key`	`STRING`	要提取的键。
	`value`	`ANY`	给定键的默认值。默认值是：`null`。
	`fail`	`BOOLEAN`	如果键不存在且未提供默认值，如果设置为 true，它将抛出异常；否则返回 null 值。默认值是：`true`。
返回值	`ANY`

使用示例

以下示例在尝试查找缺失键 missingKey 且未提供默认值时抛出异常

WITH {name:"Cristiano Ronaldo",country:"Portugal",dob:date("1985-02-05")} AS map
RETURN apoc.map.get(map, "missingKey") AS output;

结果
输出
Neo.ClientError.Procedure.ProcedureCallFailed: 调用函数 `apoc.map.get` 失败：原因：java.lang.IllegalArgumentException: 键 missingKey 不属于现有键 [country, dob, name] 中的任何一个

以下示例在尝试查找缺失键 missingKey 时返回默认值 defaultValue

WITH {name:"Cristiano Ronaldo", country:"Portugal", dob:date("1985-02-05")} AS map
RETURN apoc.map.get(map, "missingKey", "defaultValue") AS output;

结果
输出
"defaultValue"