【system.array】使用说明

对象：system.array

说明：提供一系列针对数组类型的操作

目录：

方法	返回	说明
system.array.join( array, separator )	[String]	将数组转换成字符串
system.array.length( array )	[Number]	获取数组元素个数
system.array.concat( array1, array2, ..., arrayX )	[Array]	连接多个数组，返回连接后的新数组
system.array.remove( array, start, howMany )	[Array]	移除数组中指定位置、指定个数的元素，并返回移除后的新数组
system.array.insert( array, index, newElement )	[Array]	在指定的位置处插入新元素，并返回插入后的新数组
system.array.splice( array, start, howMany, newElement1, newElement1, ...,  newElementX )	[Array]	移除数组中指定位置、指定个数的元素，并在其位置处插入新元素。返回操作后的新数组
system.array.removeRepeat( array )	[Array]	移除数组中重复的元素，并返回移除后的新数组（只适合元素值是常规类型的判断）
system.array.push( array, newElement1, newElement2, ..., newElementX )	[Array]	数组的末尾添加一个或多个元素，并返回新的数组（操作不会更改arrObj的值）
system.array.unshift( array, newElement1, newElement2, ..., newElementX )	[Array]	向数组的开头添加一个或更多元素，并返回新的数组（操作不会更改arrObj的值）
system.array.reverse( array )	[Array]	获取颠倒数组中元素的新数组。
system.array.toArray( string, separator, ignoreCaseg )	[Array]	将字符串转换成数组
system.array.sort( array, rule )	[Array]	数组排序
system.array.slice( array, start, end )	[Array]	指定起始位置与结束位置的元素，并组合成新的数组（元素位置从1开始）
system.array.rndElements(array, nums)	[Array]	从数组中随机取出指定个数的元素并返回
system.array.every( array, funName, extParam )	[Boolean]	检测数组所有元素是否都符合指定条件（通过外接函数检测）
system.array.some( array, funName, extParam )	[Boolean]	检测数组内是否含有满足条件的元素（通过外接函数检测）
system.array.map( array, funName, extParam )	[Array]	返回一个新数组，数组中的每一个元素为原始数组元素调用外接原型处理后的值
system.array.filter( array, funName, extParam )	[Array]	返回数组内符合条件的元素
system.array.reduce( array, funName, extParam )	[任意类型]	将数组中的元素按从左到右的顺序，计算为一个值
system.array.reduceRight( array, funName, extParam )	[任意类型]	将数组中的元素按从右到左的顺序，计算为一个值

方法：

原型: system.array.join(array, separator)
说明: 将数组转换成字符串
返回: [String]
参数:
        array [必需 Array] 数组
        separator [必需 String] 数组元素分隔符

原型: system.array.length(array)
说明: 获取数组元素个数
返回: [Number]
参数:
        array [必需 Array] 数组

原型: system.array.concat(array1, array2, ..., arrayX)
说明: 连接多个数组，返回连接后的数组
返回: [Array]
参数:
        array1 [必需 Array] 数组
        array2 [可选 Array]
        ...
        arrayX [可选 Array]

原型: system.array.remove(array, start, howMany)
说明: 移除数组中指定位置、指定个数的元素，并返回移除后的新数组
返回: [Array]
参数:
        array [必需 Array] 数组
        start [必需 Number] 移除的起始位置
        howMany [可选 Number] 移除数量，不设置时表示只移动index位置的元素

原型: system.array.insert(array, index, byVal newElement)
说明: 在指定的位置处插入新元素，并返回插入后的新数组
返回: [Array]
参数:
        array [必需 Array] 数组
        index [必需 Number] 插入位置
        newElement [必需 任意类型] 要插入的元素

原型: system.array.splice(array, start, howMany, newElement1, newElement1, ...,  newElementX)
说明: 移除数组中指定位置、指定个数的元素，并在其位置处插入新元素。返回操作后的新数组
返回: [Array]
参数:
        array [必需 Array] 数组
        start [必需 Number] 移除的起始位置
        howMany [必需 Number] 移除数量
        newElement1 [必需 任意类型] 要插入的元素
        newElement2 [必需 任意类型] 要插入的元素
        ...
        newElementX [必需 任意类型] 要插入的元素

原型: system.array.removeRepeat(array)
说明: 移除数组中重复的元素，并返回移除后的新数组（只适合元素值是常规类型的判断）
返回: [Array]
参数:
        array [必需 Array] 数组

原型: system.array.push(array, newElement1, newElement2, ..., newElementX)
说明: 数组的末尾添加一个或多个元素，并返回新的数组（操作不会更改arrObj的值）
返回: [Array]
参数:
        array [必需 Array] 数组
        newElement1 [必需 任意类型] 添加的新元素值
        newElement2 [必需 任意类型] 添加的新元素值
        ...
        newElementX [可选 任意类型] 添加的新元素值

原型: system.array.unshift(array, newElement1, newElement2, ..., newElementX)
说明: 向数组的开头添加一个或更多元素，并返回新的数组（操作不会更改arrObj的值）
返回: [Array]
参数:
        array [必需 Array] 数组
        newElement1 [必需 任意类型] 添加的新元素值
        newElement2 [必需 任意类型] 添加的新元素值
        ...
        newElementX [可选 任意类型] 添加的新元素值

原型: system.array.reverse(array)
说明: 获取颠倒数组中元素的新数组。
返回: [Array]
参数:
        array [必需 Array] 数组

原型: system.array.toArray(string, separator, ignoreCaseg)
说明: 将字符串转换成数组
返回: [Array]
参数:
        string [必需 String] 字符串
        separator [必需 String] 分隔符
        ignoreCaseg [可选 Boolean] 是否忽略大小写，默认值true

原型: system.array.sort(array, rule)
说明: 数组排序
返回: [Array]
参数:
        array [必需 Array] 数组
        rule [必需 0|1|2|3|4|5] 排序规则
              0 按字典顺序
              1 字典倒序
              2 按数字从小到大排
              3 按数字从大小到排
              4 按日期从前到后排
              5 按日期从后到前排

原型: system.array.slice(array, start, end)
说明: 指定起始位置与结束位置的元素，并组合成新的数组（元素位置从1开始）
返回: [Array]
参数:
        array [必需 Array] 数组
        start [必需 Number] 起始位置
        end [可选 Number] 结束位置，如果不设置表示只截取start的元素

原型: system.array.every(array, funName, extParam)
说明: 检测数组所有元素是否都符合指定条件（通过外接函数检测）
返回: [Boolean]
参数:
        array [必需 Array] 数组
        funName [必需 String] 外接函数名称字符串
        extParam [可选] 给外接函数提供扩展参数
                 外接函数需要单独定义: 
                 原型: Function funName(item, index, arrObj) 或当使用了extParam时，定义为： Function funName(item, index, arrObj, extParam)
                 返回: [Boolean] 
                 参数: item 数组元素值、index 数组元素的索引值、arrObj 数组

注意: 外接函数funName检测元素不符合条件时返回False，同时不再执行后面元素的检测

原型: system.array.some(array, funName, extParam)
说明: 检测数组内是否含有满足条件的元素（通过外接函数检测）
返回: [Boolean]
参数:
        array [必需 Array] 数组
        funName [必需 String] 外接函数名称字符串，同every函数
        extParam [可选] 给外接函数提供扩展参数，同every函数

注意: 外接函数funName检测元素符合条件时返回True，同时不再执行后面元素的检测

原型: system.array.map(array, funName, extParam)
说明: 返回一个新数组，数组中的每一个元素为原始数组元素调用外接原型处理后的值
返回: [Array]
参数:
        array [必需 Array] 数组
        funName [必需 String] 外接函数名称字符串
        extParam [可选] 给外接函数提供扩展参数
                  外接函数需要单独定义:
                  原型: Function funName(item, index, arrObj) 或当使用了extParam时，定义为： Function funName(item, index, arrObj, extParam)
                  返回: [任意类型] 更改后的元素值 
                  参数: item 数组元素值、index 数组元素的索引值、arrObj 数组

原型: system.array.filter(array, funName, extParam)
说明: 返回数组内符合条件的元素
返回: [Array]
参数: 同every参数

原型: system.array.reduce(array, funName, extParam)
说明: 将数组中的元素按从左到右的顺序，计算为一个值
返回: [任意类型]
参数:
        array [必需 Array] 数组
        funName [必需 String] 外接函数名称字符串（外接函数返回计算后的结果，当返回False时，表示中止后面的执行操作）

外接函数需要定义: 原型: Function funName(byVal total, byVal item, byVal index, byVal arrObj) 返回: [Boolean] 该元素符合条件返回true 参数: total 每个元素计算后的结果值、 item 数组元素值、index 数组元素的索引值、arrObj 数组

原型: system.array.reduceRight(array, funName, extParam)
说明: 将数组中的元素按从右到左的顺序，计算为一个值
返回: [任意类型]
参数:
        array [必需 Array] 数组
        funName   [必需 String] 外接函数名称字符串（外接函数返回计算后的结果，当返回False时，表示中止后面的执行操作）
                  外接函数需要定义:
                  原型: Function funName(byVal total, byVal item, byVal index, byVal arrObj)
                  返回: [Boolean] 该元素符合条件返回true
                  参数: total 每个元素计算后的结果值、 item 数组元素值、index 数组元素的索引值、arrObj 数组

原型: system.array.rndElements(arrObj, nums)
说明: 从数组中随机取出指定个数的元素并返回
返回: [Array]
参数:
        array [必需 Array] 数组
        nums  [必需 Number] 取出个数，如果该数值大于数组个数则返回所有元素