0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看技术视频
  • 写文章/发帖/加入社区
会员中心
创作中心

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

鸿蒙语言基础类库:ohos.util.ArrayList 线性容器ArrayList

jf_46214456 来源:jf_46214456 作者:jf_46214456 2024-07-10 09:37 次阅读

线性容器ArrayList

icon-note.gif说明: 本模块首批接口从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

名称参数类型可读可写说明
lengthnumberArrayList的元素个数。

constructor

constructor()

ArrayList的构造函数。

系统能力: SystemCapability.Utils.Lang

示例:

let arrayList = new ArrayList();

add

add(element: T): boolean

在ArrayList尾部插入元素。

系统能力: SystemCapability.Utils.Lang

参数:

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

返回值:

类型说明
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

参数:

参数名类型必填说明
elementT被插入的元素。
indexnumber被插入的位置索引

示例:

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

参数:

参数名类型必填说明
elementT指定元素。

返回值:

类型说明
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

参数:

参数名类型必填说明
elementT指定元素。

返回值:

类型说明
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

参数:

参数名类型必填说明
elementT指定元素。

返回值:

类型说明
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

参数:

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

返回值:

类型说明
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

参数:

参数名类型必填说明
elementT指定元素。

返回值:

类型说明
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

参数:

参数名类型必填说明
fromIndexnumber起始下标。
toIndexnumber终止下标。

示例:

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

参数:

参数名类型必填说明
callbackfnfunction回调函数。
thisArgObjectcallbackfn被调用时用作this值。

callbackfn的参数说明:

参数名类型必填说明
valueT当前遍历到的元素。
indexnumber当前遍历到的下标值。
arrlistArrayList当前调用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

参数:

参数名类型必填说明
callbackfnfunction回调函数。
thisArgObjectcallbackfn被调用时用作this值。

callbackfn的参数说明:

参数名类型必填说明
valueT当前遍历到的元素。
indexnumber当前遍历到的下标值。
arrlistArrayList当前调用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

参数:

参数名类型必填说明
comparatorfunction回调函数。

comparator的参数说明:

参数名类型必填说明
firstValueT前一项元素。
secondValueT后一项元素。

示例:

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

参数:

参数名类型必填说明
fromIndexnumber起始下标。
toIndexnumber终止下标。

返回值:

类型说明
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

参数:

参数名类型必填说明
newCapacitynumber新容量。

示例:

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

返回值:

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

QQ截图20240705210937.png

示例:

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;
}

审核编辑 黄宇

声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • 鸿蒙
    +关注

    关注

    57

    文章

    2345

    浏览量

    42822
收藏 人收藏

    评论

    相关推荐

    OpenHarmony语言基础【@ohos.util.ArrayList (线性容器ArrayList)】

    ArrayList是一种线性数据结构,底层基于数组实现。ArrayList会根据实际需要动态调整容量,每次扩容增加50%。
    的头像 发表于 04-25 18:48 622次阅读
    OpenHarmony<b class='flag-5'>语言</b>基础<b class='flag-5'>类</b><b class='flag-5'>库</b>【@<b class='flag-5'>ohos.util.ArrayList</b> (<b class='flag-5'>线性</b><b class='flag-5'>容器</b><b class='flag-5'>ArrayList</b>)】

    labview调用C# dll文件如何传递ArrayList类型参数?

    labview调用C# dll文件时,没有找到有效的ArrayList类型参数传递方式。尝试过强制类型转换、调用库函数节点均未能实现(可能是我的配置方式有问题,期待大神答疑解惑)。
    发表于 10-13 09:18

    ArrayList的get/get如何操作?

    ArrayList的特点是什么ArrayList的get操作ArrayList的add操作
    发表于 11-09 06:43

    HarmonyOS方舟开发框架容器API的介绍与使用

    通过数组实现,包括ArrayList、Vector、List、LinkedList、Deque、Queue、Stack七种。线性容器API,充分考虑了数据访问的速度,实现了运行时(R
    发表于 03-07 11:40

    OpenHarmony 3.1 Beta版本关键特性解析——ArkUI容器API介绍

    及使用场景。下面,我们将为大家一一道来。1.1线性容器线性容器底层主要通过数组实现,包括
    发表于 04-24 14:58

    【学习打卡】OpenHarmony的ArrayList介绍

    在底层的集合允许我们在List 接口的帮助下插入和删除元素。List 接口是一个有序的对象集合,允许存储重复值。 ArrayList是OpenHarmony中实现List接口特性的,具有结构
    发表于 07-27 21:51

    OpenHarmony应用示例:线性容器 ArrayList

    简介本示例通过线性容器 ArrayList 模拟了添加删除联系人的操作,展示了 ArrayList 相关的接口功能。效果图如下:相关概念线性
    发表于 08-15 14:31

    HarmonyOS线性容器特性及使用场景

    \'@ohos.util.ArrayList\'; // 导入ArrayList模块 let arrayList = new ArrayList();
    发表于 09-27 15:10

    JDK中java.util.ArrayList 的介绍

    1、ArrayList 定义 ArrayList 是一个用数组实现的集合,支持随机访问,元素有序且可以重复。 public class ArrayList E > extends
    的头像 发表于 10-10 15:51 657次阅读
    JDK中java.<b class='flag-5'>util.ArrayList</b> <b class='flag-5'>类</b>的介绍

    ArrayList入门实践

    构造函数 ArrayList 有三个构造函数,默认不带参数的构造函数就是初始化一个空数组。 //一个空数组 private static final Object
    的头像 发表于 10-10 16:36 368次阅读
    <b class='flag-5'>ArrayList</b>入门实践

    java的util包下有哪些

    在Java的util包下,包含了许多,用于提供各种常见的实用工具和数据结构。以下是一些常见的ArrayList:动态数组,可以根据需要自动调整大小。 LinkedList:双向
    的头像 发表于 11-22 15:04 1120次阅读

    鸿蒙语言基础ohos.util.Deque 线性容器Deque

    Deque(double ended queue)根据循环队列的数据结构实现,符合先进先出以及先进后出的特点,支持两端的元素插入和移除。Deque会根据实际需要动态调整容量,每次进行两倍扩容。
    的头像 发表于 07-10 09:19 234次阅读
    <b class='flag-5'>鸿蒙语言</b>基础<b class='flag-5'>类</b><b class='flag-5'>库</b>:<b class='flag-5'>ohos.util</b>.Deque <b class='flag-5'>线性</b><b class='flag-5'>容器</b>Deque

    鸿蒙语言基础ohos.util.HashMap 非线性容器HashMap

    HashMap底层使用数组+链表+红黑树的方式实现,查询、插入和删除的效率都很高。HashMap存储内容基于key-value的键值对映射,不能有重复的key,且一个key只能对应一个value。
    的头像 发表于 07-10 16:31 443次阅读
    <b class='flag-5'>鸿蒙语言</b>基础<b class='flag-5'>类</b><b class='flag-5'>库</b>:<b class='flag-5'>ohos.util</b>.HashMap 非<b class='flag-5'>线性</b><b class='flag-5'>容器</b>HashMap

    鸿蒙语言基础ohos.util.TreeSet 非线性容器TreeSet

    TreeSet基于[TreeMap]实现,在TreeSet中,只对value对象进行处理。TreeSet可用于存储一系列值的集合,元素中value唯一且有序。
    的头像 发表于 07-11 16:25 328次阅读
    <b class='flag-5'>鸿蒙语言</b>基础<b class='flag-5'>类</b><b class='flag-5'>库</b>:<b class='flag-5'>ohos.util</b>.TreeSet 非<b class='flag-5'>线性</b><b class='flag-5'>容器</b>TreeSet

    鸿蒙语言基础ohos.util.Vector 线性容器Vector

    Vector是一种线性数据结构,底层基于数组实现。当Vector的内存用尽时,会自动分配更大的连续内存区,将原先的元素复制到新的内存区,并释放旧的内存区。使用Vector能够高效快速地访问元素。
    的头像 发表于 07-11 09:56 236次阅读
    <b class='flag-5'>鸿蒙语言</b>基础<b class='flag-5'>类</b><b class='flag-5'>库</b>:<b class='flag-5'>ohos.util</b>.Vector <b class='flag-5'>线性</b><b class='flag-5'>容器</b>Vector