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

news/2024/12/23 5:27:30/

 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/news/1447347.html

相关文章

linux安装Redis 7.2.4笔记

linux安装Redis 7.2.4笔记

一.保姆级安装 1.下载Redis 7.2.4安装包 sudo wget https://download.redis.io/releases/redis-7.2.4.tar.gz2.解压&#xff0c;可以指定 sudo tar -zvxf redis-7.2.4.tar.gz 3.检测并安装 GCC 编译器&#xff1a; yum 是基于 Red Hat 的 Linux 发行版&#xff08;如 CentOS、…
阅读更多...
FPGA高端项目：FPGA帧差算法多目标图像识别+目标跟踪，提供11套工程源码和技术支持

FPGA高端项目：FPGA帧差算法多目标图像识别+目标跟踪，提供11套工程源码和技术支持

目录 1、前言免责声明 2、相关方案推荐FPGA帧差算法单个目标图像识别目标跟踪 3、详细设计方案设计原理框图运动目标检测原理OV5640摄像头配置与采集OV7725摄像头配置与采集RGB视频流转AXI4-StreamVDMA图像缓存多目标帧差算法图像识别目标跟踪模块视频输出Xilinx系列FPGA工程源…
阅读更多...
vue3子组件调父组件方法

vue3子组件调父组件方法

在 Vue 3 中&#xff0c;子组件通常不会直接调用父组件的方法&#xff0c;因为这同样违反了组件之间的单向数据流原则。然而&#xff0c;你可以通过$emit方式实现子组件通知父组件并执行某些操作&#xff1a; 父组件 子组件可以通过 $emit 触发一个自定义事件&#xff0c;并传递…
阅读更多...
Llama 3 ——开源大模型Llama 3从概念到使用

Llama 3 ——开源大模型Llama 3从概念到使用

概述 Meta公司自豪地宣布推出其最新的开源大型语言模型——Llama 3&#xff0c;这是一款专为未来AI挑战而设计的先进工具。Llama 3包含两个不同参数规模的版本&#xff0c;以满足多样化的计算需求&#xff1a; 8B版本&#xff1a;优化了在消费级GPU上的部署和开发流程&#xf…
阅读更多...
CTF（Capture The Flag）编码方式

CTF（Capture The Flag）编码方式

CTF&#xff08;Capture The Flag&#xff09;比赛中&#xff0c;编码和解码是常见的挑战类别之一&#xff0c;涉及到各种不同的编码方式。以下是一些CTF中可能出现的编码技术列表&#xff1a; Base系列编码&#xff1a; Base16&#xff08;Hexadecimal&#xff09;&#xff1a…
阅读更多...
golang sync pool

golang sync pool

sync.Pool是内置对象池技术&#xff0c;可用于缓存临时对象&#xff0c;避免因频繁建立临时对象所带来的消耗以及对GC造成的压力 在很多知名框架中都可以看到sync.Pool的大量使用。比如Gin中用sync.Pool来复用每个请求都会创建的gin.Context对象 但是值得注意的是sync.Pool缓…
阅读更多...
JAVA读取从WPS在Excel中嵌入的图片资源

JAVA读取从WPS在Excel中嵌入的图片资源

读取从WPS在Excel中嵌入的图片资源 引言 许多数据文件中可能包含嵌入式图片&#xff0c;这些图片对于数据分析和可视化非常重要。然而&#xff0c;从 WPS 在 Excel 中读取这些图片可能会有一些技术挑战。在本文中&#xff0c;我将展示如何从 WPS Excel 文件中读取嵌入的图片&am…
阅读更多...
【Python】字符串

【Python】字符串

1. 字符串读取、拼接、匹配、随机生成 2. ‘’.join()连接字符串 3. 使用了random随机函数 4. 字符串列表里面使用判断语句调用函数 1、输入一个字符串,将该字符串中下标为偶数的字符组成新串并通过字符串格式化方式显示。 def get_even_indexed_chars(s):# 使用…
阅读更多...
最新文章

Copyright @ 2022~2023