鸿蒙NEXT开发：ArkTS API-@ohos.util.ArrayList (线性容器ArrayList)

最新推荐文章于 2025-05-06 22:06:09 发布

原创

最新推荐文章于 2025-05-06 22:06:09 发布 · 878 阅读

23 ·

CC 4.0 BY-SA版权

文章标签：

#harmonyos #华为 #android #前端 #鸿蒙系统 #ArkUI #ArkTS

往期鸿蒙5.0全套实战文章必看：（文中附带全栈鸿蒙5.0学习资料）

@ohos.util.ArrayList (线性容器ArrayList)

ArrayList是一种线性数据结构，底层基于数组实现。ArrayList会根据实际需要动态调整容量，每次扩容增加50%。

ArrayList和Vector相似，都是基于数组实现。它们都可以动态调整容量，但Vector每次扩容增加1倍。

ArrayList和LinkedList相比，ArrayList的随机访问效率更高。但由于ArrayList的增删操作会影响数组内其他元素的移动，LinkedList的增加和删除操作效率更高。

推荐使用场景： 当需要频繁读取集合中的元素时，推荐使用ArrayList。

文档中存在泛型的使用，涉及以下泛型标记符：

T：Type，类

说明

本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import { ArrayList } from '@kit.ArkTS';

ArrayList

属性

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Utils.Lang

名称	类型	可读	可写	说明
length	number	是	否	ArrayList的元素个数。

constructor

constructor()

ArrayList的构造函数。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Utils.Lang

错误码：

以下错误码的详细介绍。

错误码ID	错误信息
10200012	The ArrayList's constructor cannot be directly invoked.

示例：

let arrayList: ArrayList<string | number> = new ArrayList();

add

add(element: T): boolean

在ArrayList尾部插入元素。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

系统能力： SystemCapability.Utils.Lang

参数：

参数名	类型	必填	说明
element	T	是	待插入的元素。

返回值：

类型	说明
boolean	插入成功返回true，失败返回false。

错误码：

以下错误码的详细介绍。

错误码ID	错误信息
10200011	The add method cannot be bound.

示例：

class C1 {
  name: string = ""
  age: string = ""
}
let arrayList: ArrayList<string | number | boolean | Array<number> | C1> = new ArrayList();
let result1 = arrayList.add("a");
let result2 = arrayList.add(1);
let b = [1, 2, 3];
let result3 = arrayList.add(b);
let c : C1 = {name: "Dylan", age: "13"}
let result4 = arrayList.add(c);
let result5 = arrayList.add(false);