【system.array】使用说明

对象:system.array

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

目录:

方法 返回 说明
 system.array.joinarray, separator )  [String]  将数组转换成字符串
 system.array.lengtharray )  [Number]  获取数组元素个数
 system.array.concatarray1, array2, ..., arrayX )  [Array]  连接多个数组,返回连接后的新数组
 system.array.removearray, 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] 取出个数,如果该数值大于数组个数则返回所有元素

 

posted @ 2018-11-23 11:39  1024记忆  阅读(985)  评论(0编辑  收藏  举报