# 数组函数

数组函数用于操作数组或返回有关数组的信息。

# CARDINALITY

cardinality(array)
1

返回数组中的元素数。

# ARRAY_POSITION

array_position(array, value)
1

返回第二个参数在列表参数中的索引下标位置,索引下标从 0 开始,若该元素不存在,则返回 -1。

# ELEMENT_AT

element_at(array, index)
1

返回列表参数中在给定索引下的元素,索引下标从 0 开始,若该索引小于 0,则该元素从列表末向列表头进行计数。

# ARRAY_CONTAINS

array_contains(array, value)
1

返回给定元素是否存在列表参数中,存在则返回 true,否则返回 false。

# ARRAY_CREATE

array_create(value1, ......)
1

将给定的元素参数们创建为一个列表元素。

# ARRAY_REMOVE

array_remove(array, value)
1

返回删除了所有出现的给定元素的数组。

# ARRAY_LAST_POSITION

array_last_position(array, val)
1

返回第二个参数在列表参数中最后一次出现的下标位置,索引下标从 0 开始,若该元素不存在,则返回 -1。

# ARRAY_CONTAINS_ANY

array_contains_any(array1, array2)
1

返回第一个参数中是否存在第二个参数中的任意一个元素,存在则返回 true,否则返回 false。

# ARRAY_INTERSECT

array_intersect(array1, array2)
1

返回两个数组的交集,且不包含重复元素。

# ARRAY_UNION

array_union(array1, array2)
1

返回两个数组的并集,且不包含重复元素。

# ARRAY_MAX

array_max(array)
1

返回数组中的最大值, 数组元素中的 null 值将被忽略。

# ARRAY_MIN

array_min(array)
1

返回数组中的最小值, 数组元素中的 null 值将被忽略。

# ARRAY_EXCEPT

array_except(array1, array2)
1

返回第一个数组中存在,但第二个数组中不存在的元素,且不包含重复元素。

# REPEAT

repeat(value, count)
1

返回一个由给定元素参数重复出现指定次数的列表元素。

# SEQUENCE

sequence(start, stop[, step])
1

返回一个从第一个开始参数到第二个结束参数的整数列表,每个元素按照给定的步长递增或递减。若未提供步长,则默认为 1(如果第一个开始参数小于第二个结束参数),或 -1(如果第一个开始参数大于第二个结束参数),且步长不允许为 0。

# ARRAY_CARDINALITY

array_cardinality(array)
1

返回数组中的元素数。数组中的 null 值不计算在内。

# ARRAY_FLATTEN

array_flatten(array)
1

返回一个扁平化的数组,即将数组中的数组元素展开。

例如,传入参数为 [[1, 4], [2, 3]],则返回 [1, 4, 2, 3]。

# ARRAY_DISTINCT

array_distinct(array)
1

返回一个去重的数组,即将数组中的重复元素去除。

# ARRAY_MAP

array_map(function_name, array)
1

返回一个新的数组,其中包含对给定数组中的每个元素应用给定函数的结果。

# ARRAY_JOIN

array_join(array, delimiter, null_replacement)
1

返回一个字符串,其中包含给定数组中的所有元素,元素之间用给定的分隔符分隔。如果数组中的元素为 null,则用给定的 null_replacement 替换。

例如,传入参数为 [1, 2, 3],delimiter 设置为逗号,则返回 “1,2,3”。

# ARRAY_SHUFFLE

array_shuffle(array)
1

返回一个随机排序的数组。

# ARRAY_CONCAT

array_concat(array1, array2, ...)
1

用于合并两个或多个数组。此函数不会更改现有数组,而是返回一个新的数组。

# ARRAY_SORT

array_sort(array)
1

返回输入数组的排序副本。

array_sort([3, 2, "b", "a"])
1

结果:

[2, 3, "a", "b"]
1