历史版本10 :数组函数概述 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. ADD2ARRAY编辑

ADD2ARRAY(array, insertArray, start):在数组 array 的第 start 个位置插入 insertArray 中的所有元素,再返回该数组。

示例:

ADD2ARRAY([3, 4, 1, 5, 7], [23, 43, 22], 3)返回[3, 4, 23, 43, 22, 1, 5, 7]。

ADD2ARRAY([3, 4, 1, 5, 7], "测试", 3)返回[3, 4, "测试", 1, 5, 7]。

注:如果 start 为小于 1 的数或者不写 start 参数,则默认从数组的第一位开始插入数组元素。

2. ARRAY编辑

ARRAY(arg1,arg2...):返回一个由 arg1,arg2,...组成的数组. [arg1,arg2,...]可以由字符串或者数字构成。

示例:

ARRAY("hello")返回[hello]。

ARRAY("hello","world")返回[hello,world]。

ARRAY("hello",98)返回[hello,98]。

ARRAY(67,98)返回[67,98]。

3. GREPARRAY编辑

GREPARRAY(array,fn):通过 fn 过滤 array 数组,返回过滤后的新数组。过滤函数必须返回 true 以保留元素或 false 以删除元素。

array 为待过滤数组,fn 为过滤函数。

示例:

GREPARRAY([3,4,2,3,6,8,7], item != 3)返回[4,2,6,8,7] 。

4. INARRAY编辑

INARRAY(co, array):返回 co 在数组 array 中的位置,如果 co 不在 array 中,则返回 0。

示例:

如果String[] arr = {"a","b","c","d"} ,则:

INARRAY("b", arr)返回 2。

INARRAY("e", arr)返回 0

5. INDEXOFARRAY编辑

INDEXOFARRAY(array, index):返回数组 array 的第 index 个元素。

示例:

INDEXOFARRAY(["第一个", "第二个", "第三个"], 2)返回"第二个"。

6. MAPARRAY编辑

MAPARRAY(array, fn):批量处理数组,通过fn对数组中的元素进行转换。 array:要转换的数组;fn:处理数组项目的函数 。

示例:

MAPARRAY([3,4,2,3,6,8,7], item != 3)返回[false,true,true,false,true,true,true]。

MAPARRAY([3,4,2,-3,6,8,-5],if(item>0,1,0)),返回[1,1,1,0,1,1,0]。

7. RANGE编辑

RANGE(from,to,step)函数表示从整数 from 开始,以 step 为每一步的示例:直到整数 to 的一个数字序列。

注: RANGE 函数有三种参数形式,第一种 RANGE(to),缺省默认 from 为 1,step为 1 ;第二种 RANGE(from,to),默认的 step 为 1;第三种 RANGE(from,to,step),参数的情况参照上面的注释。

示例:

RANGE(4)返回[1,2,3,4]。

RANGE(-5)返回[]。

RANGE(-1,3)返回[-1,0,1,2,3]。

RANGE(0,5)返回[0,1,2,3,4,5]。

RANGE(6,-1,-2)返回[6,4,2,0]。

RANGE(4,1,1)返回[]。

8. REMOVEARRAY编辑

REMOVEARRAY(array, start, deleteCount):从数组 array 中删除从第 start 个元素开始的 deleteCount 个数组元素,并返回删除后的数组。

示例:

REMOVEARRAY([3, 4, 4, 2, 6, 7, 87], 4, 2)返回[3, 4, 4, 7, 87]。

9. REVERSEARRAY编辑

REVERSEARRAY(array):返回数组 array 的倒序数组。

示例:

REVERSEARRAY(["第一个", "第二个", "第三个"])返回["第三个", "第二个", "第一个"]

注:使用 REVERSEARRAY 函数时,参数必须是数组,如果参数不是数组,必须使用 SPLIT 函数将其转换为数组,SPLIT 函数使用参见 SPLIT

10. SLICEARRAY编辑

SLICEARRAY(array, start, end):返回数组从第 start 个到第 end 个元素(包括第 end 个元素)。

示例:

SLICEARRAY([3, 4, 4, 5, 1, 5, 7], 3, 6)返回[4, 5, 1, 5]。 

SLICEARRAY([3, 4, 4, 5, 1, 5, 7], 3)返回[4, 5, 1, 5, 7]。

注:当不使用 end 参数时,返回从 start 开始到数组结束之间的元素。

11. SORTARRAY编辑

SORTARRAY(array):返回数组 array 排过序的数组 ,默认升序排列。

示例:

SORTARRAY([3, 4, 4, 5, 1, 5, 7])返回[1, 3, 4, 4, 5, 5, 7]。

注:数组 array 的元素类型必须一样,并且要可比较。

12. UNIQUEARRAY编辑

UNIQUEARRAY(array):去重,去掉数组 array 中的重复元素,以保留第一次出现的元素为序,返回去重之后的数组。

示例:

UNIQUEARRAY([14, 2, 3, 4, 3, 2, 5, 6, 2, 7, 9, 12, 3])返回[14, 2, 3, 4, 5, 6, 7, 9, 12]。