apoc.map.values

详细信息

语法

apoc.map.values(map [, keys, addNullsForMissing ])

描述

返回由给定键指定的 LIST<ANY>(如果某个键不存在,则返回 null 值)。

参数

名称

类型

描述

Map

MAP

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

keys

LIST<STRING>

要从给定映射中提取的键列表。默认值为:[]

addNullsForMissing

布尔值 (BOOLEAN)

是否将缺失的值作为 null 值返回。默认值为:false

返回

LIST<ANY>

使用示例

以下示例返回键 namecountry 的值列表,并为缺失的键 missingKey 返回一个 null 值(同时使用了 APOC 和 Cypher)

apoc.map.values
WITH {name:"Cristiano Ronaldo",country:"Portugal",dob:date("1985-02-05")} AS map
RETURN apoc.map.values(map, ["name", "country", "missingKey"], true) AS output
使用 Cypher 的动态映射访问
WITH {name:"Cristiano Ronaldo",country:"Portugal",dob:date("1985-02-05")} AS map
RETURN [map["name"], map["country"], map["missingKey"]] AS output
使用 Cypher 的 COLLECT 子查询
WITH {name:"Cristiano Ronaldo",country:"Portugal",dob:date("1985-02-05")} AS map
RETURN COLLECT {
    UNWIND ["name", "country", "missingKey"] AS key
    RETURN map[key]
} AS output
结果
输出

["Cristiano Ronaldo","Portugal",null]

以下示例返回键 namecountry 的值列表,但不会为缺失的键 missingKey 返回任何内容(同时使用了 APOC 和 Cypher)

apoc.map.values
WITH {name:"Cristiano Ronaldo",country:"Portugal",dob:date("1985-02-05")} AS map
RETURN apoc.map.values(map, ["name", "country", "missingKey"], false) AS output
使用 Cypher 的动态映射访问和 collect()
WITH {name:"Cristiano Ronaldo",country:"Portugal",dob:date("1985-02-05")} AS map
UNWIND ["name", "country", "missingKey"] AS key
RETURN collect(map[key])
结果
输出

["Cristiano Ronaldo","Portugal"]