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

ops/2025/1/12 15:44:22/

 PlainArray可用于存储具有关联关系的key-value键值对集合，存储元素中key值唯一，key值类型为number类型，每个key对应一个value。

PlainArray依据泛型定义，采用轻量级结构，集合中key值的查找依赖于二分查找算法，然后映射到其他数组中的value值。

PlainArray和[LightWeightMap]都是用来存储键值对，且均采用轻量级结构，但PlainArray的key值类型只能为number类型。

推荐使用场景：  当需要存储key值为number类型的键值对时，可以使用PlainArray。

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

  • T：Type，类

说明：

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

导入模块

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

PlainArray

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

属性

系统能力：  SystemCapability.Utils.Lang

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

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

constructor

constructor()

PlainArray的构造函数。

系统能力：  SystemCapability.Utils.Lang

错误码：

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

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

示例：

let plainArray = new PlainArray();

isEmpty

isEmpty(): boolean

判断该容器是否为空。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

错误码：

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

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

示例：

const plainArray = new PlainArray();
let result = plainArray.isEmpty();

has

has(key: number): boolean

判断此容器中是否含有该指定key。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
keynumber是指定key。

返回值：

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

错误码：

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

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

示例：

let plainArray = new PlainArray();
plainArray.add(1, "squirrel");
let result = plainArray.has(1);

get

get(key: number): T

获取指定key所对应的value。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
keynumber是查找的指定key。

返回值：

类型说明
T返回key映射的value值。

错误码：

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

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

示例：

let plainArray = new PlainArray();
plainArray.add(1, "squirrel");
plainArray.add(2, "sparrow");
let result = plainArray.get(1);

getIndexOfKey

getIndexOfKey(key: number): number

查找指定key对应的下标值，如果没有找到该key返回-1。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
keynumber是指定key。

返回值：

类型说明
number返回指定key对应的下标值，查找失败返回-1。

错误码：

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

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

示例：

let plainArray = new PlainArray();
plainArray.add(1, "squirrel");
plainArray.add(2, "sparrow");
let result = plainArray.getIndexOfKey(2);

getIndexOfValue

getIndexOfValue(value: T): number

查找指定value元素第一次出现的下标值，如果没有找到该value元素返回-1。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

错误码：

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

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

示例：

let plainArray = new PlainArray();
plainArray.add(1, "squirrel");
plainArray.add(2, "sparrow");
let result = plainArray.getIndexOfValue("squirrel");

getKeyAt

getKeyAt(index: number): number

查找指定下标元素键值对中的key值。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

类型说明
number返回该下标元素键值对中的key值，失败返回-1。

错误码：

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

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

示例：

let plainArray = new PlainArray();
plainArray.add(1, "squirrel");
plainArray.add(2, "sparrow");
let result = plainArray.getKeyAt(1);

getValueAt

getValueAt(index: number): T

查找指定下标元素键值对中的Value值，失败返回undefined。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

类型说明
T返回该下标元素键值对中的value值，失败返回undefined。

错误码：

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

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

示例：

let plainArray = new PlainArray();
plainArray.add(1, "squirrel");
plainArray.add(2, "sparrow");
let result = plainArray.getValueAt(1);

clone

clone(): PlainArray<T>

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

系统能力：  SystemCapability.Utils.Lang

返回值：

类型说明
PlainArray<T>返回新的对象实例。

错误码：

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

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

示例：

let plainArray = new PlainArray();
plainArray.add(1, "squirrel");
plainArray.add(2, "sparrow");
let newPlainArray = plainArray.clone();

add

add(key: number, value: T): void

向容器中添加一组数据。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
keynumber是添加成员数据的键名。
valueT是添加成员数据的值。

错误码：

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

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

示例：

let plainArray = new PlainArray();
plainArray.add(1, "squirrel");

remove

remove(key: number): T

删除指定key对应的键值对。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
keynumber是指定key。

返回值：

类型说明
T返回所删除的键值对中的Value值。

错误码：

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

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

示例：

let plainArray = new PlainArray();
plainArray.add(1, "squirrel");
plainArray.add(2, "sparrow");
let result = plainArray.remove(2);

removeAt

removeAt(index: number): T

删除指定下标对应的元素。

系统能力：  SystemCapability.Utils.Lang

参数：

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

返回值：

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

错误码：

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

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

示例：

let plainArray = new PlainArray();
plainArray.add(1, "squirrel");
plainArray.add(2, "sparrow");
let result = plainArray.removeAt(1);

removeRangeFrom

removeRangeFrom(index: number, size: number): number

删除一定范围内的元素。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
indexnumber是删除元素的起始下标。
sizenumber是期望删除元素个数。

返回值：

类型说明
number实际删除元素个数。

错误码：

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

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

示例：

let plainArray = new PlainArray();
plainArray.add(1, "squirrel");
plainArray.add(2, "sparrow");
let result = plainArray.removeRangeFrom(1, 3);

setValueAt

setValueAt(index: number, value: T): void

替换容器中指定下标对应键值对中的键值。

系统能力：  SystemCapability.Utils.Lang

参数：

参数名类型必填说明
indexnumber是指定替换数据下标。
valueT是替换键值对中的值。

错误码：

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

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

示例：

let plainArray = new PlainArray();
plainArray.add(1, "squirrel");
plainArray.add(2, "sparrow");
plainArray.setValueAt(1, 3546);

toString

toString(): String

获取包含容器中所有键和值的字符串。

系统能力：  SystemCapability.Utils.Lang

返回值：

类型说明
String返回对应字符串。

错误码：

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

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

示例：

​
let plainArray = new PlainArray();
plainArray.add(1, "squirrel");
plainArray.add(2, "sparrow");
let result = plainArray.toString();​

clear

clear(): void

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

系统能力：  SystemCapability.Utils.Lang

错误码：

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

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

示例：

let plainArray = new PlainArray();
plainArray.add(1, "squirrel");
plainArray.add(2, "sparrow");
plainArray.clear();

forEach

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

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

系统能力：  SystemCapability.Utils.Lang

参数：

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

callbackfn的参数说明：

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

错误码：

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

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

示例：

let plainArray = new PlainArray();
plainArray.add(1, "squirrel");
plainArray.add(2, "sparrow");
plainArray.forEach((value, index) => {console.log("value:" + value, "index:" + index);
});

[Symbol.iterator]

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

返回一个包含key-value键值对的迭代器对象，其中key是number类型。

系统能力：  SystemCapability.Utils.Lang

返回值：

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

错误码：

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

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

示例：

let plainArray = new PlainArray();
plainArray.add(1, "squirrel");
plainArray.add(2, "sparrow");// 使用方法一：
for (let item of plainArray) { console.log("key:" + item[0]);console.log("value:" + item[1]);
}// 使用方法二：
let iter = plainArray[Symbol.iterator]();
let temp = iter.next().value;
while(temp != undefined) {console.log("key:" + temp[0]);console.log("value:" + temp[1]);temp = iter.next().value;
}

鸿蒙语言有TS、ArkTS等语法，那么除了这些基础知识之外，其核心技术点有那些呢？下面就用一张整理出的鸿蒙学习路线图表示：

从上面的OpenHarmony技术梳理来看，鸿蒙的学习内容也是很多的。现在全网的鸿蒙学习文档也是非常的少，下面推荐一些：完整内容可在头像页保存，或这qr23.cn/AKFP8k甲助力

内容包含：《鸿蒙NEXT星河版开发学习文档》

  • ArkTS
  • 声明式ArkUI
  • 多媒体
  • 通信问题
  • 系统移植
  • 系统裁剪
  • FW层的原理
  • 各种开发调试工具
  • 智能设备开发
  • 分布式开发等等。

这些就是对往后开发者的分享，希望大家多多点赞关注喔！


http://www.ppmy.cn/ops/20600.html

相关文章

Taro引入echarts【兼容多端小程序（飞书/微信/支付宝小程序）】

Taro引入echarts【兼容多端小程序（飞书/微信/支付宝小程序）】

近期接到公司新需求&#xff0c;开发飞书小程序&#xff0c;并且原型中含有大量的图表&#xff0c;本想使用飞书内置图表组件 —— chart-space&#xff0c;但官方表示已经停止维护了&#xff0c;无奈之下&#xff0c;只能另寻他路&#xff0c;于是乎&#xff0c;图表之王&…
阅读更多...
OpenHarmony实战开发-如何实现文本输入 (TextInput/TextArea)

OpenHarmony实战开发-如何实现文本输入 (TextInput/TextArea)

TextInput、TextArea是输入框组件&#xff0c;通常用于响应用户的输入操作&#xff0c;比如评论区的输入、聊天框的输入、表格的输入等&#xff0c;也可以结合其它组件构建功能页面&#xff0c;例如登录注册页面。 创建输入框 TextInput为单行输入框、TextArea为多行输入框。…
阅读更多...
【原创】向量加权平均算法优化的长短期记忆神经网络自注意力神经网络(INFO-LSTM-SelfAttention)的回归预测

【原创】向量加权平均算法优化的长短期记忆神经网络自注意力神经网络(INFO-LSTM-SelfAttention)的回归预测

INFO-LSTM-SelfAttention是一种用于回归预测的神经网络模型&#xff0c;结合了长短期记忆&#xff08;LSTM&#xff09;神经网络、自注意力机制和向量加权平均算法。下面详细介绍这个模型在回归预测任务中的工作流程&#xff1a; 1. 数据预处理 输入数据&#xff1a;时序数据序…
阅读更多...
记录用php制作上传本地图片并获取图片地址/本地图床的方法

记录用php制作上传本地图片并获取图片地址/本地图床的方法

要实现一个允许用户上传本地图片并获取图片地址的功能，你需要使用HTML来创建文件上传表单，使用PHP来处理上传的文件，以及可能需要JavaScript来增强用户体验（比如预览图片）。以下是一个简单的示例，展示如何使用这些技术实现图片上传功能。 HTML部分 创建一个表单，让用户…
阅读更多...
vue3 ——笔记 (表单输入，监听器)

vue3 ——笔记 (表单输入，监听器)

表单输入 在Vue 3中&#xff0c;v-model指令的用法稍有不同于Vue 2。在Vue 3中&#xff0c;v-model指令实际上是一个语法糖&#xff0c;它会自动将value属性和input事件绑定到组件或元素上&#xff0c;以实现双向数据绑定。 在自定义组件中使用v-model时&#xff0c;需要在组…
阅读更多...
jenkins教程

jenkins教程

jenkins 一、简介二、下载安装三、配置jdk、maven和SSH四、部署微服务 一、简介 Jenkins是一个流行的开源自动化服务器&#xff0c;用于自动化软件开发过程中的构建、测试和部署任务。它提供了一个可扩展的插件生态系统&#xff0c;支持各种编程语言和工具。 Jenkins是一款开…
阅读更多...
history命令

history命令

history 命令&#xff1a; history 命令用于显示当前用户在命令行中输入的历史命令列表。它会列出之前执行过的所有命令&#xff0c;每条命令都会有一个编号。这个命令不进行过滤或搜索&#xff0c;只是简单地列出了所有的命令历史记录。 history | grep “git”&#xff1a;…
阅读更多...
HTTP的MIME 类型（2024-04-27）

HTTP的MIME 类型（2024-04-27）

1、简介 MIME (Multipurpose Internet Mail Extensions) 是描述消息内容类型的标准&#xff0c;用来表示文档、文件或字节流的性质和格式。 MIME 消息能包含文本、图像、音频、视频以及其他应用程序专用的数据。 浏览器通常使用 MIME 类型&#xff08;而不是文件扩展名&…
阅读更多...
最新文章

Copyright @ 2022~2023