FineReport数组函数

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

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

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 个元素。

示例：

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

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

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)返回[]。

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