数组、列表和设置函数

Profile Query Language (PQL)优惠函数可使与数组、列表和字符串的交互更简单。有关其他PQL函数的详细信息，请参阅Profile Query Language overview。

入

in函数用于确定项目是否是数组或列表的成员。

格式

{VALUE} in {ARRAY}

示例

以下PQL查询定义三月、六月或九月的生日。

person.birthMonth in [3, 6, 9]

不在

notIn函数用于确定项目是否不是数组或列表的成员。

格式

{VALUE} notIn {ARRAY}

示例

以下PQL查询定义生日不在3月、6月或9月的人。

person.birthMonth notIn [3, 6, 9]

Intersects

intersects函数用于确定两个阵列或列表是否具有至少一个公共成员。

格式

{ARRAY}.intersects({ARRAY})

示例

以下PQL查询定义其最喜爱的颜色至少包括红色、蓝色或绿色之一的人。

person.favoriteColors.intersects(["red", "blue", "green"])

交集

intersection函数用于确定两个阵列或列表的公用成员。

格式

{ARRAY}.intersection({ARRAY})

示例

以下PQL查询定义人物1和人物2是否都具有最喜爱的红色、蓝色和绿色。

person1.favoriteColors.intersection(person2.favoriteColors) = ["red", "blue", "green"]

子集

subsetOf函数用于确定特定阵列（阵列A）是否是另一阵列（阵列B）的子集。 换句话说，数组A中的所有元素都是数组B的元素。

格式

{ARRAY}.subsetOf({ARRAY})

示例

以下PQL查询定义访问过其所有喜爱城市的人员。

person.favoriteCities.subsetOf(person.visitedCities)

超集

supersetOf函数用于确定特定阵列（阵列A）是否是另一阵列（阵列B）的超集。 换句话说，数组A包含数组B中的所有元素。

格式

{ARRAY}.supersetOf({ARRAY})

示例

以下PQL查询定义了至少吃过一次寿司和比萨的人。

person.eatenFoods.supersetOf(["sushi", "pizza"])

包括

includes函数用于确定数组或列表是否包含给定项。

格式

{ARRAY}.includes({ITEM})

示例

以下PQL查询定义其喜爱颜色包含红色的人。

person.favoriteColors.includes("red")

Distinct

distinct函数用于从数组或列表中删除重复值。

格式

{ARRAY}.distinct()

示例

以下PQL查询指定在多个商店中下订单的人员。

person.orders.storeId.distinct().count() > 1

分组依据

groupBy函数用于根据列表的值将数组或表达式的值划分到组中。

格式

{ARRAY}.groupBy({EXPRESSION)

示例

以下PQL查询将存储订单的所有订单分组。

orders.groupBy(storeId)

过滤器

filter函数用于根据表达式过滤数组或列表。

格式

{ARRAY}.filter({EXPRESSION})

示例

以下PQL查询定义所有21岁或以上的人。

person.filter(age >= 21)

地图

map函数用于通过对给定数组中的每个项应用表达式来创建新数组。

格式

array.map(expression)

示例

以下PQL查询将创建一个新的数字数组，并将原始数字的值用正方形表示。

numbers.map(square)

数组中的第一个n

topN函数用于返回数组中的前一个N项，当这些项基于给定的数字表达式按升序排序时。

格式

{ARRAY}.topN({VALUE}, {AMOUNT})

示例

以下PQL查询返回价格最高的前5个订单。

orders.topN(price, 5)

数组中最后一个n

bottomN函数用于返回数组中最后的N项，当这些项根据给定的数字表达式按升序排序时。

格式

{ARRAY}.bottomN({VALUE}, {AMOUNT})

示例

以下PQL查询返回价格最低的前5个订单。

orders.bottomN(price, 5)

第一项

head函数用于返回数组或列表中的第一个项。

格式

{ARRAY}.head()

示例

以下PQL查询返回价格最高的前五个订单中的第一个。 有关topN函数的详细信息，请参阅数组🔗部分的第一个n。

orders.topN(price, 5).head()

后续步骤

您已经了解了阵列、列表和设置函数，现在可以在PQL查询中使用它们。 有关其他PQL函数的详细信息，请阅读用户档案查询语言概述。