数组函数概述

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 参数，则默认从数组的第一位开始插入数组元素。

1）概述

2）注意事项

当使用公式嵌套数组单元格时，如果数组单元格内实际是单值，会作为单值处理，需要嵌套 ARRAY 公式确保单元格始终作为数组计算（多值则不需要），比如 B2=ARRAY(1), 使用 INARRAY 函数应该写成：INARRAY(1,ARRAY(B2))，如下图所示：

如果写成 INARRAY(1,B2)，则无法返回有效数据，如下图所示：

3）示例

GREPARRAY(array,fn)：通过 fn 条件过滤 array 数组，返回过滤后的新数组。

示例：

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

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

注：fn 参数必须符合格式要求，否则过滤不生效。比如名称没有定义成 item/index，返回值为原数组。

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

示例：

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

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

INARRAY("e", arr)返回 0。

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

array：需要返回元素的数组。

index：数组元素的下标。

示例：

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

在单元格中输入=indexofarray(["a","b","c","d"],3)，获取数组中第三个位置的数据即返回值为 c。

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]。

1）概述

2）示例

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

示例：

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

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

示例：

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

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

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 开始到数组结束之间的元素。

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

示例：

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

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

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]。

JOINARRAY(array,sepa)：返回一个由sepa作为分隔符的字符串。

array：[arg1,arg2...]格式的数组;

sepa：分隔符。

示例：

JOINARRAY([1,2],";")=1;2

JOINARRAY(['hello','world'],"-")=hello-world

若数组在使用模拟计算时，参数需要写成[1,2,3,4,5]格式。

例如输入公式：INDEXOFARRAY(A2, 2)，希望返回数组的第二个数字，则点击模拟计算后需要输入的参数格式为：[1,2,3,4,5]，此时得出的模拟计算结果为2，如下图所示：