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

最新推荐文章于 2024-07-30 10:19:36 发布
最新推荐文章于 2024-07-30 10:19:36 发布
阅读量956 收藏 17
点赞数 21
分类专栏： 鸿蒙 文章标签： harmonyos 鸿蒙开发 openharmony 移动开发 鸿蒙 鸿蒙系统 程序员
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2301_76813281/article/details/138250127
版权
本文介绍了鸿蒙系统中List数据结构的特点，与LinkedList的比较，以及其在插入、删除等操作中的优缺点。同时涵盖了List的各种方法，如添加、查找、排序等，以及与之相关的泛型使用和开发指导。
摘要由CSDN通过智能技术生成

 List底层通过单向链表实现，每个节点有一个指向后一个元素的引用。当需要查询元素时，必须从头遍历，插入、删除效率高，查询效率低。List允许元素为null。

List和[LinkedList]相比，LinkedList是双向链表，可以快速地在头尾进行增删，而List是单向链表，无法双向操作。

推荐使用场景：  当需要频繁的插入删除时，推荐使用List高效操作。

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

  • T：Type，类

说明：

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

导入模块

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

List

鸿蒙开发指导文档：gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。

属性

系统能力：  SystemCapability.Utils.Lang

名称类型可读可写说明
lengthnumber是否List的元素个数。

搜狗高速浏览器截图20240326151450.png

constructor

constructor()

List的构造函数。

系统能力：  SystemCapability.Utils.Lang

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

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

示例：

let list = new List();

add

add(element: T): boolean

在List尾部插入元素。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
elementT是添加进去的元素。

返回值：

类型说明
boolean插入成功返回true，否则返回false。

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

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

示例：

let list = new List();
let result1 = list.add("a");
let result2 = list.add(1);
let b = [1, 2, 3];
let result3 = list.add(b);
let c = {name : "Dylon", age : "13"};
let result4 = list.add(c);
let result5 = list.add(false);

insert

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

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

错误码ID错误信息
10200011The insert method cannot be bound.
10200001The value of index is out of range.

示例：

let list = new List();
list.insert("A", 0);
list.insert(0, 1);
list.insert(true, 2);

has

has(element: T): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

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

示例：

let list = new List();
list.add("squirrel");
let result = list.has("squirrel");

get

get(index: number): T

根据下标获取List中的元素。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
indexnumber是要查找的下标。

返回值：

类型说明
T根据下标查找到的元素。

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

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

示例：

let list = new List();
list.add(2);
list.add(4);
list.add(5);
list.add(2);
list.add(1);
list.add(2);
list.add(4);
let result = list.get(2);

getLastIndexOf

getLastIndexOf(element: T): number

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

类型说明
number返回指定元素最后一次出现的下标值，没有找到返回-1。

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

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

示例：

let list = new List();
list.add(2);
list.add(4);
list.add(5);
list.add(2);
list.add(1);
list.add(2);
list.add(4);
let result = list.getLastIndexOf(2);

getIndexOf

getIndexOf(element: T): number

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

类型说明
number返回第一次找到指定元素的下标，没有找到返回-1。

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

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

示例：

let list = new List();
list.add(2);
list.add(4);
list.add(5);
list.add(2);
list.add(1);
list.add(2);
list.add(4);
let result = list.getIndexOf(2);

equal

equal(obj: Object): boolean

比较指定对象与此List是否相等。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
objObject是用来比较的对象。

返回值：

类型说明
boolean如果对象与此列表相同返回true，否则返回false。

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

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

示例：

let list = new List();
list.add(2);
list.add(4);
list.add(5);
let obj = new List();
obj.add(2);
obj.add(4);
obj.add(5);
let result = list.equal(obj);

removeByIndex

removeByIndex(index: number): T

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

错误码ID错误信息
10200011The removeByIndex method cannot be bound.
10200001The value of index is out of range.

示例：

let list = new List();
list.add(2);
list.add(4);
list.add(5);
list.add(2);
list.add(4);
let result = list.removeByIndex(2);

remove

remove(element: T): boolean

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

类型说明
boolean删除成功返回true，否则返回false。

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

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

示例：

let list = new List();
list.add(2);
list.add(4);
list.add(5);
list.add(4);
let result = list.remove(2);

replaceAllElements

replaceAllElements(callbackFn: (value: T, index?: number, list?: List<T>) => T, thisArg?: Object): void

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

callbackfn的参数说明：

参数名类型必填说明
valueT是当前遍历到的元素。
indexnumber否当前遍历到的下标值。
listList<T>否当前调用replaceAllElements方法的实例对象。

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

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

示例：

let list = new List();
list.add(2);
list.add(4);
list.add(5);
list.add(4);
list.replaceAllElements((value) => {
  // 用户操作逻辑根据实际场景进行添加。
  return value;
});

forEach

forEach(callbackFn: (value: T, index?: number, List?: List<T>) => void, thisArg?: Object): void

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

callbackfn的参数说明：

参数名类型必填说明
valueT是当前遍历到的元素。
indexnumber否当前遍历到的下标值。
ListList<T>否当前调用forEach方法的实例对象。

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

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

示例：

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

sort

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

对List中的元素进行一个排序操作。

系统能力：  SystemCapability.Utils.Lang

参数：

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

comparator的参数说明：

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

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

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

示例：

let list = new List();
list.add(2);
list.add(4);
list.add(5);
list.add(4);
list.sort((a: number, b: number) => a - b); // 结果为升序排列
list.sort((a: number, b: number) => b - a); // 结果为降序排列

getSubList

getSubList(fromIndex: number, toIndex: number): List<T>

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

类型说明
List<T>返回List对象实例。

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

错误码ID错误信息
10200011The getSubList method cannot be bound.
10200001The value of fromIndex or toIndex is out of range.

示例：

let list = new List();
list.add(2);
list.add(4);
list.add(5);
list.add(4);
let result = list.getSubList(1, 3);

clear

clear(): void

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

系统能力：  SystemCapability.Utils.Lang

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

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

示例：

let list = new List();
list.add(2);
list.add(4);
list.add(5);
list.add(4);
list.clear();

set

set(index: number, element: T): T

将此 List 中指定位置的元素替换为指定元素。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
indexnumber是查找的下标值。
elementT是用来替换的元素。

返回值：

类型说明
T返回替换后的元素

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

错误码ID错误信息
10200011The set method cannot be bound.
10200001The value of index is out of range.

示例：

let list = new List();
list.add(2);
list.add(4);
list.add(5);
list.add(4);
let result = list.set(2, "b");

convertToArray

convertToArray(): Array<T>

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

系统能力：  SystemCapability.Utils.Lang

返回值：

类型说明
Array<T>返回转换后的数组。

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

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

示例：

let list = new List();
list.add(2);
list.add(4);
list.add(5);
list.add(4);
let result = list.convertToArray();

isEmpty

isEmpty(): boolean

判断该List是否为空。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

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

示例：

let list = new List();
list.add(2);
list.add(4);
list.add(5);
list.add(4);
let result = list.isEmpty();

getFirst

getFirst(): T

获取List实例中的第一个元素。

系统能力：  SystemCapability.Utils.Lang

返回值：

类型说明
T返回实例的第一个元素。

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

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

示例：

let list = new List();
list.add(2);
list.add(4);
list.add(5);
list.add(4);
let result = list.getFirst();

getLast

getLast(): T

获取List实例中的最后一个元素。

系统能力：  SystemCapability.Utils.Lang

返回值：

类型说明
T返回实例的最后一个元素。

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

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

示例：

let list = new List();
list.add(2);
list.add(4);
list.add(5);
list.add(4);
let result = list.getLast();

[Symbol.iterator]

[Symbol.iterator](): IterableIterator<T>

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

系统能力：  SystemCapability.Utils.Lang

返回值：

类型说明
IterableIterator<T>返回一个迭代器。

错误码：

以下错误码的详细介绍请参见语言基础类库错误码。

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

示例：

let list = new List();
list.add(2);
list.add(4);
list.add(5);
list.add(4);

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

// 使用方法二：
let iter = list[Symbol.iterator]();
let temp = iter.next().value;
while(temp != undefined) {
  console.log("value: " + temp);
  temp = iter.next().value;
}

最后呢，很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

高清完整版请点击→《鸿蒙NEXT星河版开发学习文档》

针对鸿蒙成长路线打造的鸿蒙学习文档。话不多说，我们直接看详细资料鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，帮助大家在技术的道路上更进一步。

《鸿蒙 (OpenHarmony)开发学习视频》

图片

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

获取这份鸿蒙星河版学习资料，请点击→《鸿蒙NEXT星河版开发学习文档》

OpenHarmony北向、南向开发环境搭建

图片

《鸿蒙开发基础》

  1. ArkTS语言

  2. 安装DevEco Studio

  3. 运用你的第一个ArkTS应用

  4. ArkUI声明式UI开发

  5. .……

图片

《鸿蒙开发进阶》

  1. Stage模型入门

  2. 网络管理

  3. 数据管理

  4. 电话服务

  5. 分布式应用开发

  6. 通知与窗口管理

  7. 多媒体技术

  8. 安全技能

  9. 任务管理

  10. WebGL

  11. 国际化开发

  12. 应用测试

  13. DFX面向未来设计

  14. 鸿蒙系统移植和裁剪定制

  15. ……

图片

《鸿蒙开发实战》

  1. ArkTS实践

  2. UIAbility应用

  3. 网络案例

  4. ……

图片

 获取这份鸿蒙星河版学习资料，请点击→《鸿蒙NEXT星河版开发学习文档》

总结

鸿蒙—作为国家主力推送的国产操作系统。部分的高校已经取消了安卓课程，从而开设鸿蒙课程；企业纷纷跟进启动了鸿蒙研发。

并且鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，未来将会支持 50 万款的应用。那么这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！

爱桥代码的程序媛
关注
  • 21
    点赞
  • 踩
  • 17
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
HarmonyOS实战开发：@ohos.util.ArrayList (线性容器ArrayList)
初一十五的博客
04-23 1028
ArrayList是一种线性数据结构，底层基于数组实现.........
鸿蒙语言基础类库：【@ohos.util.ArrayList (线性容器ArrayList)】
2301_76813281的博客
07-09 1045
本模块首批接口从API version 8开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。点击或者复制转到。ArrayList是一种线性数据结构，底层基于数组实现。ArrayList会根据实际需要动态调整容量，每次扩容增加50%。ArrayList和[Vector]相似，都是基于数组实现。它们都可以动态调整容量，但Vector每次扩容增加1倍。ArrayList和[LinkedList]相比，ArrayList的随机访问效率更高。
OpenHarmony语言基础类库【@ohos.util.LinkedList (线性容器LinkedList)】
2301_76813281的博客
04-26 948
LinkedList底层通过双向链表实现，双向链表的每个节点都包含对前一个元素和后一个元素的引用。当需要查询元素时，可以从头遍历，也可以从尾部遍历，插入、删除效率高，查询效率低。LinkedList允许元素为null。LinkedList和[List]相比，LinkedList是双向链表，可以快速地在头尾进行增删，而List是单向链表，无法双向操作。
HarmonyOS实战开发：@ohos.util.List (线性容器List)
初一十五的博客
04-24 765
List底层通过单向链表实现，每个节点有一个指向后一个元素的引用..........
HarmonyOS实战开发：@ohos.util.LinkedList (线性容器LinkedList)
初一十五的博客
04-24 919
LinkedList底层通过双向链表实现.........
鸿蒙OpenHarmony大合集：【语言基础类库】
2301_76813281的博客
04-29 1373
鸿蒙是完全具备无与伦比的机遇和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开发，这么多的应用需要开发，也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！
ArtTS语言基础类库-容器类库内容的学习(2.10.2）
jay_chess的博客
06-29 664
【代码】ArtTS语言基础类库-容器类库内容的学习(2.10.2）
HarmonyOS实战开发-ArkTS语言基础类库（容器类库）解析
HarmonyOS_002的博客
07-07 591
●如果你觉得这篇内容对你还蛮有帮助，我想邀请你帮我两个小忙：●关注小编，同时可以期待后续文章ing🚀，不定期分享原创知识。
Java语言程序设计.doc
12-21
Java是一种广泛使用的面向对象的编程语言，以其平台独立性和丰富的类库而闻名。在Java中，程序设计涉及语法、数据结构、算法以及面向对象的设计原则等多个方面。 1. 栈（Stack）是计算机科学中一种线性数据结构，...
新版Android开发教程.rar
12-14
----------------------------------- Android 编程基础 1 封面----------------------------------- Android 编程基础 2 开放手机联盟 --Open --Open --Open --Open Handset Handset Handset Handset Alliance ...
grafo-lista-adj
02-17
Java提供了丰富的类库，如`java.util.ArrayList`和`java.util.LinkedList`，可以方便地构建邻接列表。在邻接列表中，每个顶点都有一个列表，包含了与其相邻的所有顶点。这种结构允许快速访问和修改顶点的相邻关系，...
算法：以不同语言实现的数据结构和算法
02-13
Java是一种广泛使用的面向对象编程语言，以其平台无关性和强大的类库支持而闻名。在数据结构方面，Java提供了内置的数据结构，如数组、链表、队列、栈、集合、映射等。这些基础数据结构在解决实际问题时扮演着重要...
COMP410:来自COMP410的分配-数据结构
04-07
在Java编程语言中，数据结构的实现尤为重要，因为Java提供了丰富的类库来支持这些结构。以下是对这个主题的一些详细知识点的探讨： 1. **数组**：数组是最基本的数据结构，它允许存储固定数量的同类型元素。在Java...
鸿蒙 Navigation VS Router 对比
Dev Blog
07-24 1140
鸿蒙关于页面跳转提供了两套解决方案，一套是页面路由 router，一套是组件导航 Navigation。前期我们在基建开发期间，采用的页面路由 router 方案，@zz/router 组件代码已经开发完毕了，但是到了开发 WebView 的 Hybrid 接口时，才意识到一个严重的问题，就是 router 提供的能力，并不能满足我们复杂的页面栈管理，譬如在页面栈中多个 WebView，我们需要关闭指定的 WebView 页面，router 提供的 API 能力是无法做到的。支持，需要先import页面。
HarmonyOS NEXT星河版零基础入门到实战
stc_ljc的博客
07-24 757
放弃安卓框架之后，HarmonyOS NEXT成为真正独立于安卓、iOS的操作系统，堪称是一场史无前例的脱胎换骨。在其众多新特性中，原生智能无疑是最能带给用户直观感受和体验升级的新特性之一。HarmonyOS NEXT首次将AI与OS深度融合，构筑了全新鸿蒙原生智能框架，真正开启了全新的AI时代。
HarmonyOS持久化存储数据Preference
张雨的博客
07-24 511
【代码】HarmonyOS持久化存储数据Preference。
FrameWork学习笔记
最新发布
qq_18420641的博客
07-30 277
FW
手机删除的照片怎么找回? 3个急救指南,让你重新拥有
qq_23996309的博客
07-29 897
您是否曾意外删除了重要照片和一堆无用照片？除了感到后悔，您还能做什么？幸运的是，您可以借助我们的以下教程恢复丢失的照片。请记住，请不要对您的设备进行任何操作。无论您使用的是 iPhone、iPad、iPod 还是 Android 手机、平板电脑，请查看以下指南以逐步恢复已删除的照片。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值