鸿蒙语言基础类库：【@ohos.util.ArrayList (线性容器ArrayList)】

爱桥代码的程序媛2024-07-10 22:43

线性容器ArrayList

说明： 本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。开发前请熟悉鸿蒙开发指导文档 ：gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。

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

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

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

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

导入模块

import ArrayList from '@ohos.util.ArrayList';

ArrayList

属性

系统能力： SystemCapability.Utils.Lang

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

constructor

constructor()

ArrayList的构造函数。

系统能力： SystemCapability.Utils.Lang

示例：

let arrayList = new ArrayList();

add

add(element: T): boolean

在ArrayList尾部插入元素。

系统能力： SystemCapability.Utils.Lang

参数：

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

返回值：

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

示例：

let arrayList = new ArrayList();
let result = arrayList.add("a");
let result1 = arrayList.add(1);
let b = [1, 2, 3];
let result2 = arrayList.add(b);
let c = {name: "lala", age: "13"};
let result3 = arrayList.add(false);

insert

insert(element: T, index: number): void

在长度范围内任意位置插入指定元素。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
element T 是 被插入的元素。
index number 是 被插入的位置索引。

示例：

let arrayList = new ArrayList();
arrayList.insert("A", 0);
arrayList.insert(0, 1);
arrayList.insert(true, 2);

has

has(element: T): boolean

判断此ArrayList中是否含有该指定元素。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
element T 是 指定元素。

返回值：

类型 说明
boolean 返回true表示包含指定元素，否则返回false。

示例：

let arrayList = new ArrayList();
let result = arrayList.has("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
arrayList.add("Ahfbrgrbgnutfodgorrogorgrogofdfdf");
let result1 = arrayList.has("Ahfbrgrbgnutfodgorrogorgrogofdfdf");

getIndexOf

getIndexOf(element: T): number

返回指定元素第一次出现时的下标值，查找失败返回-1。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
element T 是 指定元素。

返回值：

类型 说明
number 返回指定元素第一次出现时的下标值，查找失败返回-1。

示例：

let arrayList = new ArrayList();
arrayList.add(2);
arrayList.add(4);
arrayList.add(5);
arrayList.add(2);
arrayList.add(1);
arrayList.add(2);
arrayList.add(4);
let result = arrayList.getIndexOf(2);

getLastIndexOf

getLastIndexOf(element: T): number

返回指定元素最后一次出现时的下标值，查找失败返回-1。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
element T 是 指定元素。

返回值：

类型 说明
number 返回指定元素最后一次出现时的下标值，查找失败返回-1。

示例：

let arrayList = new ArrayList();
arrayList.add(2);
arrayList.add(4);
arrayList.add(5);
arrayList.add(2);
arrayList.add(1);
arrayList.add(2);
arrayList.add(4);
let result = arrayList.getLastIndexOf(2);

removeByIndex

removeByIndex(index: number): T

根据元素的下标值查找元素，返回元素后将其删除。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
index number 是 指定元素的下标值。

返回值：

类型 说明
T 返回删除的元素。

示例：

let arrayList = new ArrayList();
arrayList.add(2);
arrayList.add(4);
arrayList.add(5);
arrayList.add(2);
arrayList.add(4);
let result = arrayList.removeByIndex(2);

remove

remove(element: T): boolean

删除查找到的第一个指定的元素。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
element T 是 指定元素。

返回值：

类型 说明
boolean 删除成功返回true，失败返回false。

示例：

let arrayList = new ArrayList();
arrayList.add(2);
arrayList.add(4);
arrayList.add(5);
arrayList.add(4);
let result = arrayList.remove(2);

removeByRange

removeByRange(fromIndex: number, toIndex: number): void

从一段范围内删除元素，包括起始值但不包括终止值。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
fromIndex number 是 起始下标。
toIndex number 是 终止下标。

示例：

let arrayList = new ArrayList();
arrayList.add(2);
arrayList.add(4);
arrayList.add(5);
arrayList.add(4);
arrayList.removeByRange(2, 4);
arrayList.removeByRange(4, 3);
arrayList.removeByRange(2, 6);

replaceAllElements

replaceAllElements(callbackfn: (value: T, index?: number, arrlist?: ArrayList) => T, thisArg?: Object): void

用户操作ArrayList中的元素，用操作后的元素替换原元素并返回操作后的元素。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
callbackfn function 是 回调函数。
thisArg Object 否 callbackfn被调用时用作this值。

callbackfn的参数说明：

参数名 类型 必填 说明
value T 是 当前遍历到的元素。
index number 否 当前遍历到的下标值。
arrlist ArrayList 否 当前调用replaceAllElements方法的实例对象。

示例：

let arrayList = new ArrayList();
arrayList.add(2);
arrayList.add(4);
arrayList.add(5);
arrayList.add(4);
arrayList.replaceAllElements((value: number, index: number)=> {
  return value = 2 * value;
});
arrayList.replaceAllElements((value: number, index: number) => {
  return value = value - 2;
});

forEach

forEach(callbackfn: (value: T, index?: number, arrlist?: ArrayList) => void, thisArg?: Object): void

通过回调函数来遍历ArrayList实例对象上的元素以及元素对应的下标。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
callbackfn function 是 回调函数。
thisArg Object 否 callbackfn被调用时用作this值。

callbackfn的参数说明：

参数名 类型 必填 说明
value T 是 当前遍历到的元素。
index number 否 当前遍历到的下标值。
arrlist ArrayList 否 当前调用forEach方法的实例对象。

示例：

let arrayList = new ArrayList();
arrayList.add(2);
arrayList.add(4);
arrayList.add(5);
arrayList.add(4);
arrayList.forEach((value, index) => {
  console.log("value:" + value, index);
});

sort

sort(comparator?: (firstValue: T, secondValue: T) => number): void

对ArrayList中的元素排序。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
comparator function 否 回调函数。

comparator的参数说明：

参数名 类型 必填 说明
firstValue T 是 前一项元素。
secondValue T 是 后一项元素。

示例：

let arrayList = new ArrayList();
arrayList.add(2);
arrayList.add(4);
arrayList.add(5);
arrayList.add(4);
arrayList.sort((a: number, b: number) => a - b);
arrayList.sort((a: number, b: number) => b - a);
arrayList.sort();

subArrayList

subArrayList(fromIndex: number, toIndex: number): ArrayList

根据下标截取ArrayList中的一段元素，并返回这一段ArrayList实例，包括起始值但不包括终止值。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
fromIndex number 是 起始下标。
toIndex number 是 终止下标。

返回值：

类型 说明
ArrayList 返回ArrayList对象实例。

示例：

let arrayList = new ArrayList();
arrayList.add(2);
arrayList.add(4);
arrayList.add(5);
arrayList.add(4);
let result1 = arrayList.subArrayList(2, 4);
let result2 = arrayList.subArrayList(4, 3);
let result3 = arrayList.subArrayList(2, 6);

clear

clear(): void

清除ArrayList中的所有元素，并把length置为0。

系统能力： SystemCapability.Utils.Lang

示例：

let arrayList = new ArrayList();
arrayList.add(2);
arrayList.add(4);
arrayList.add(5);
arrayList.add(4);
arrayList.clear();

clone

clone(): ArrayList

克隆一个与ArrayList相同的实例，并返回克隆后的实例。修改克隆后的实例并不会影响原实例。

系统能力： SystemCapability.Utils.Lang

返回值：

类型 说明
ArrayList 返回ArrayList对象实例。

示例：

let arrayList = new ArrayList();
arrayList.add(2);
arrayList.add(4);
arrayList.add(5);
arrayList.add(4);
let result = arrayList.clone();

getCapacity

getCapacity(): number

获取当前实例的容量大小。

系统能力： SystemCapability.Utils.Lang

返回值：

类型 说明
number 返回arraylist的容量大小。

示例：

let arrayList = new ArrayList();
arrayList.add(2);
arrayList.add(4);
arrayList.add(5);
arrayList.add(4);
let result = arrayList.getCapacity();

convertToArray

convertToArray(): Array

把当前ArrayList实例转换成数组，并返回转换后的数组。

系统能力： SystemCapability.Utils.Lang

返回值：

类型 说明
Array 返回数组类型。

示例：

let arrayList = new ArrayList();
arrayList.add(2);
arrayList.add(4);
arrayList.add(5);
arrayList.add(4);
let result = arrayList.convertToArray();

isEmpty

isEmpty(): boolean

判断该ArrayList是否为空。

系统能力： SystemCapability.Utils.Lang

返回值：

类型 说明
boolean 为空返回true，不为空返回false。

示例：

let arrayList = new ArrayList();
arrayList.add(2);
arrayList.add(4);
arrayList.add(5);
arrayList.add(4);
let result = arrayList.isEmpty();

increaseCapacityTo

increaseCapacityTo(newCapacity: number): void

如果传入的新容量大于或等于ArrayList中的元素个数，将容量变更为新容量。

系统能力： SystemCapability.Utils.Lang

参数：

参数名 类型 必填 说明
newCapacity number 是 新容量。

示例：

let arrayList = new ArrayList();
arrayList.add(2);
arrayList.add(4);
arrayList.add(5);
arrayList.add(4);
arrayList.increaseCapacityTo(2);
arrayList.increaseCapacityTo(8);

trimToCurrentLength

trimToCurrentLength(): void

把容量限制为当前的length大小。

系统能力： SystemCapability.Utils.Lang

示例：

let arrayList = new ArrayList();
arrayList.add(2);
arrayList.add(4);
arrayList.add(5);
arrayList.add(4);
arrayList.trimToCurrentLength();

[Symbol.iterator]

Symbol.iterator: IterableIterator

返回一个迭代器，迭代器的每一项都是一个 JavaScript 对象，并返回该对象。

系统能力： SystemCapability.Utils.Lang

返回值：

类型 说明 HarmonyOS与OpenHarmony鸿蒙文档籽料：mau123789是v直接拿
IterableIterator 返回一个迭代器。

示例：

let arrayList = new ArrayList();
arrayList.add(2);
arrayList.add(4);
arrayList.add(5);
arrayList.add(4);

// 使用方法一：
for (let item of arrayList) { 
  console.log("value:" + item); 
} 

// 使用方法二：
let iter = arrayList[Symbol.iterator]();
let temp = iter.next().value;
while(temp != undefined) {
  console.log("value:" + temp);
  temp = iter.next().value;
}
相关推荐
小强在此1 小时前
【基于开源鸿蒙(OpenHarmony)的智慧农业综合应用系统】
华为·开源·团队开发·智慧农业·harmonyos·开源鸿蒙
PlumCarefree5 小时前
基于鸿蒙API10的RTSP播放器(四：沉浸式播放窗口)
华为·harmonyos
中关村科金8 小时前
中关村科金推出得助音视频鸿蒙SDK，助力金融业务系统鸿蒙化提速
华为·音视频·harmonyos
小强在此12 小时前
基于OpenHarmony(开源鸿蒙)的智慧医疗综合应用系统
华为·开源·团队开发·健康医疗·harmonyos·开源鸿蒙
奔跑的露西ly19 小时前
【鸿蒙 HarmonyOS NEXT】popup弹窗
华为·harmonyos
OH五星上将1 天前
OpenHarmony（鸿蒙南向开发）——轻量和小型系统三方库移植指南（一）
嵌入式硬件·移动开发·harmonyos·openharmony·鸿蒙开发·鸿蒙移植
codes234577891 天前
鸿蒙开发之ArkTS 界面篇 一
harmonyos·arkts·harmonyos next·deveco-studio·鸿蒙界面·鸿蒙界面入门·鸿蒙 index.ets
HarmonyOS_SDK1 天前
免弹窗、预授权，默认界面扫码能力打造系统级扫码体验
harmonyos
追风小老头折腾程序1 天前
实战06-LazyForEach
harmonyos
热门推荐
01RAG 实践- Ollama+RagFlow 部署本地知识库02组基轨迹建模 GBTM的介绍与实现（Stata 或 R）032024年高教社杯数学建模国赛C题超详细解题思路分析04苍穹外卖面试总结05Coze扣子平台完整体验和实践（附国内和国际版对比）06【2024数模国赛赛题思路公开】国赛B题思路丨附可运行代码丨无偿自提07CANoe Trace窗口过滤栏消失的几种解决方法（附上最终解决方案）08yolov8实战第五天——yolov8+ffmpg实时视频流检测并进行实时推流——（推流，保姆教学）09【2024高教社杯全国大学生数学建模竞赛】B题 生产过程中的决策问题——解题思路 代码 论文10浏览器插件——ModHeader 的分享和学习