【system.array】使用说明

对象：system.date

说明：提供一系列针对日期类型的操作

目录：

方法	返回	说明

方法：

原型: 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)
说明: 检测数组所有元素是否都符合指定条件（通过外接函数检测）
返回: [Boolean]
参数:
        array [必需 Array] 数组
        funName [必需 String] 外接函数名称字符串
                外接函数需要定义:
                  原型: Function funName(byVal item, byVal index, byVal arrObj)
                  返回: [Boolean]
                  参数: item 数组元素值、index 数组元素的索引值、arrObj 数组


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

原型: system.array.some(array, funName)
说明: 检测数组内是否含有满足条件的元素（通过外接函数检测）
返回: [Boolean]
参数:
        array [必需 Array] 数组
        funName [必需 String] 外接函数名称字符串
                  外接函数需要定义:
                  原型: Function funName(byVal item, byVal index, byVal arrObj)
                  返回: [Boolean]
                  参数: item 数组元素值、index 数组元素的索引值、arrObj 数组

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

原型: system.array.map(array, funName)
说明: 返回一个新数组，数组中的每一个元素为原始数组元素调用外接原型处理后的值
返回: [Array]
参数:
        array [必需 Array] 数组
        funName [必需 String] 外接函数名称字符串
                  外接函数需要定义:
                  原型: Function funName(byVal item, byVal index, byVal arrObj)
                  返回: [任意类型] 更改后的元素值
                  参数: item 数组元素值、index 数组元素的索引值、arrObj 数组

原型: system.array.filter(array, funName)
说明: 返回数组内符合条件的元素
返回: [Array]
参数:
        array [必需 Array] 数组
        funName [必需 String] 外接函数名称字符串
                  外接函数需要定义:
                  原型: Function funName(byVal item, byVal index, byVal arrObj)
                  返回: [Boolean] 该元素符合条件返回true
                  参数: item 数组元素值、index 数组元素的索引值、arrObj 数组

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

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