对象 List

Variant 数组对象,一般用以返回一组 Variant 数据

用以创建和管理数组对象,创建方法:

var collection = require("collection");
var a = new collection.List();

继承关系

构造函数

List

List 对象构造函数

new List();

List 对象构造函数

new List(Array data);

调用参数:

下标操作

数组可使用下标直接访问 Variant 数据

Variant List[];

成员属性

length

Integer, 获取数组的尺寸

readonly Integer List.length;

成员函数

freeze

冻结数组内容,禁止一些修改操作

List.freeze();

resize

修改数组尺寸

List.resize(Integer sz);

调用参数:


push

在数组结尾添加一个元素

Integer List.push(Variant v);

调用参数:

返回结果:


indexOf

返回在list中可以找到给定元素的第一个索引,如果不存在,则返回-1

Integer List.indexOf(Variant searchElement,
    Integer fromIndex = 0);

调用参数:

返回结果:

如果参数 fromIndex 中提供的索引值是一个负值,则将其作为数组末尾的一个抵消,即-1表示从最后一个元素开始查找, -2表示从倒数第二个元素开始查找 ,以此类推。

注意:如果参数中提供的索引值是一个负值,仍然从前向后查询数组。如果抵消后的索引值仍小于0,则整个数组都将会被查询。其默认值为0.


lastIndexOf

lastIndexOf() 方法返回指定元素在数组中的最后一个的索引,如果不存在则返回 -1。从数组的后面向前查找,从 fromIndex 处开始。

Integer List.lastIndexOf(Variant searchElement,
    Integer fromIndex = 0);

调用参数:

返回结果:

如果参数 searchElement 大于或等于数组的长度,则整个数组会被查找。 如果为负值,将其视为从数组末尾向前的偏移。即使该值为负,数组仍然会被从后向前查找。 如果该值为负时,其绝对值大于数组长度,则方法返回 -1,即数组不会被查找


push

在数组结尾添加一个元素

Integer List.push(...);

调用参数:

返回结果:


pushArray

在数组结尾添加一组元素

List.pushArray(Array data);

调用参数:


pop

返回数组结尾的一个元素

Variant List.pop();

返回结果:


slice

返回一个新数组,包含指定范围的数据,若范围超出缓存,则只返回有效部分数据

List List.slice(Integer start = 0,
    Integer end = -1);

调用参数:

返回结果:


concat

将当前数组与给定的一个或者多个数组合并

List List.concat(...);

调用参数:

返回结果:


every

检测全部数据是否通过测试函数

Boolean List.every(Function func,
    Value thisArg = undefined);

调用参数:

返回结果:


some

检测一些数据是否通过测试函数

Boolean List.some(Function func,
    Value thisArg = undefined);

调用参数:

返回结果:


filter

过滤通过测试的数据成为一个新的数组

List List.filter(Function func,
    Value thisArg = undefined);

调用参数:

返回结果:


forEach

遍历处理全部数据

List.forEach(Function func,
    Value thisArg = undefined);

调用参数:


map

遍历处理全部数据并返回结果

List List.map(Function func,
    Value thisArg = undefined);

调用参数:

返回结果:


reduce

遍历处理全部数据并返回累积结果

Value List.reduce(Function func,
    Value initVal = undefined);

调用参数:

返回结果:


sort

排序全部数据并返回列表本身

List List.sort(Function func);

调用参数:

返回结果:


排序全部数据并返回列表本身

List List.sort();

返回结果:


toArray

返回列表的 js 数组

Array List.toArray();

返回结果:


dispose

强制回收对象,调用此方法后,对象资源将立即释放

List.dispose();

equals

比较当前对象与给定的对象是否相等

Boolean List.equals(object expected);

调用参数:

返回结果:


toString

返回对象的字符串表示,一般返回 "[Native Object]",对象可以根据自己的特性重新实现

String List.toString();

返回结果:


toJSON

返回对象的 JSON 格式表示,一般返回对象定义的可读属性集合

Value List.toJSON(String key = "");

调用参数:

返回结果:


valueOf

返回对象本身的数值

Value List.valueOf();

返回结果: