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

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

3天内不再提示

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

jf_46214456 来源:jf_46214456 作者:jf_46214456 2024-04-26 21:21 次阅读

LightWeightSet可用于存储一系列值的集合,存储元素中value值唯一。

LightWeightSet依据泛型定义,采用轻量级结构,初始默认容量大小为8,每次扩容大小为原始容量的两倍。

集合中value值的查找依赖于hash算法,通过一个数组存储hash值,然后映射到其他数组中的value值。

LightWeightSet和[HashSet]都是用来存储键值的集合,LightWeightSet的占用内存更小。

推荐使用场景: 当需要存取某个集合或是对某个集合去重时,推荐使用占用内存更小的LightWeightSet。

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

  • T:Type,类

说明:

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

导入模块

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

LightWeightSet

属性

系统能力: SystemCapability.Utils.Lang

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

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

constructor

constructor()

LightWeightSet的构造函数。

系统能力: SystemCapability.Utils.Lang

错误码:

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

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

示例:

let lightWeightSet = new LightWeightSet();

isEmpty

isEmpty(): boolean

判断该容器是否为空。

系统能力: SystemCapability.Utils.Lang

返回值:

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

错误码:

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

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

示例:

const lightWeightSet = new LightWeightSet();
let result = lightWeightSet.isEmpty();

add

add(obj: T): boolean

向此容器中添加数据。

系统能力: SystemCapability.Utils.Lang

参数

参数名类型必填说明
objT添加的成员数据。

返回值:

类型说明
boolean成功添加元素返回true,否则返回false。

错误码:

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

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

示例:

let lightWeightSet = new LightWeightSet();
let result = lightWeightSet.add("squirrel");

addAll

addAll(set: LightWeightSet): boolean

将另一个容器中的所有元素组添加到当前容器中。

系统能力: SystemCapability.Utils.Lang

参数:

参数名类型必填说明
setLightWeightSet提供添加元素的lightWeightSet。

返回值:

类型说明
boolean成功添加元素返回true,否则返回false。

错误码:

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

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

示例:

let lightWeightSet = new LightWeightSet();
lightWeightSet.add("squirrel");
lightWeightSet.add("sparrow");
let set = new LightWeightSet();
set.add("gull");
let result = lightWeightSet.addAll(set);

hasAll

hasAll(set: LightWeightSet): boolean

判断此容器中是否含有该指定set中的所有元素。

系统能力: SystemCapability.Utils.Lang

参数:

参数名类型必填说明
setLightWeightSet比较对象。

返回值:

类型说明
boolean包含所有元素返回true,否则返回false。

错误码:

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

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

示例:

let lightWeightSet = new LightWeightSet();
lightWeightSet.add("squirrel");
lightWeightSet.add("sparrow");
let set = new LightWeightSet();
set.add("sparrow");
let result = lightWeightSet.hasAll(set);

has

has(key: T): boolean

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

系统能力: SystemCapability.Utils.Lang

参数:

参数名类型必填说明
keyT指定key

返回值:

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

错误码:

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

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

示例:

let lightWeightSet = new LightWeightSet();
lightWeightSet.add(123);
let result = lightWeightSet.has(123);

equal

equal(obj: Object): boolean

判断此容器中是否含有该指定obj同类型的对象。

系统能力: SystemCapability.Utils.Lang

参数:

参数名类型必填说明
objObject比较对象。

返回值:

类型说明
boolean构成类型相同返回true,否则返回false。

错误码:

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

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

示例:

let lightWeightSet = new LightWeightSet();
lightWeightSet.add("squirrel");
lightWeightSet.add("sparrow");
let obj = ["sparrow", "squirrel"];
let result = lightWeightSet.equal(obj);

increaseCapacityTo

increaseCapacityTo(minimumCapacity: number): void

将当前容器扩容至可以容纳指定数量元素。

系统能力: SystemCapability.Utils.Lang

参数:

参数名类型必填说明
minimumCapacitynumber需要容纳数量。

错误码:

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

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

示例:

let lightWeightSet = new LightWeightSet();
lightWeightSet.increaseCapacityTo(10);

getIndexOf

getIndexOf(key: T): number

获取指定key所对应的下标。

系统能力: SystemCapability.Utils.Lang

参数:

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

返回值:

类型说明
number在lightWeightSet中指定数据的下标。若lightWeightSet中没有要查找的元素,则返回一个负值。表示目标哈希值应该插入的位置,插入位置是从1开始计数的,负号表示这是一个插入位置而不是索引

错误码:

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

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

示例:

let lightWeightSet = new LightWeightSet();
lightWeightSet.add("squirrel");
lightWeightSet.add("sparrow");
let result = lightWeightSet.getIndexOf("sparrow");

remove

remove(key: T): T

删除并返回指定key对应的元素。

系统能力: SystemCapability.Utils.Lang

参数:

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

返回值:

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

错误码:

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

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

示例:

let lightWeightSet = new LightWeightSet();
lightWeightSet.add("squirrel");
lightWeightSet.add("sparrow");
let result = lightWeightSet.remove("sparrow");

removeAt

removeAt(index: number): boolean

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

系统能力: SystemCapability.Utils.Lang

参数:

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

返回值:

类型说明
boolean确认是否成功删除元素,成功删除元素返回true,否则返回false。

错误码:

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

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

示例:

let lightWeightSet = new LightWeightSet();
lightWeightSet.add("squirrel");
lightWeightSet.add("sparrow");
let result = lightWeightSet.removeAt(1);

getValueAt

getValueAt(index: number): T

获取此容器中指定下标对应的元素。

系统能力: SystemCapability.Utils.Lang

参数:

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

返回值:

类型说明
T返回指定下标对应的元素。

错误码:

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

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

参数:

let lightWeightSet = new LightWeightSet();
lightWeightSet.add("squirrel");
lightWeightSet.add("sparrow");
let result = lightWeightSet.getValueAt(1);

clear

clear(): void

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

系统能力: SystemCapability.Utils.Lang

错误码:

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

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

示例:

let lightWeightSet = new LightWeightSet();
lightWeightSet.add("squirrel");
lightWeightSet.add("sparrow");
lightWeightSet.clear();

toString

toString(): String

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

系统能力: SystemCapability.Utils.Lang

返回值:

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

示例:

let lightWeightSet = new LightWeightSet();
lightWeightSet.add("squirrel");
lightWeightSet.add("sparrow");
let result = lightWeightSet.toString();

toArray

toArray(): Array

获取包含此容器中所有对象的数组。

系统能力: SystemCapability.Utils.Lang

返回值:

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

错误码:

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

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

示例:

let lightWeightSet = new LightWeightSet();
lightWeightSet.add("squirrel");
lightWeightSet.add("sparrow");
let result = lightWeightSet.toArray();

values

values(): IterableIterator

返回包含此映射中包含的键值的新迭代器对象。

系统能力: SystemCapability.Utils.Lang

返回值:

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

错误码:

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

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

示例:

let lightWeightSet = new LightWeightSet();
lightWeightSet.add("squirrel");
lightWeightSet.add("sparrow");
let iter = lightWeightSet.values();
let index = 0;
while(index < lightWeightSet.length) {
  console.log(JSON.stringify(iter.next().value));
  index++;
}

forEach

forEach(callbackFn: (value?: T, key?: T, set?: LightWeightSet) => void, thisArg?: Object): void

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

系统能力: SystemCapability.Utils.Lang

参数:

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

callbackfn的参数说明:

参数名类型必填说明
valueT当前遍历到的元素。
keyT当前遍历到的元素(和value相同)。
setLightWeightSet当前调用forEach方法的实例对象。

错误码:

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

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

示例:

let lightWeightSet = new LightWeightSet();
lightWeightSet.add("sparrow");
lightWeightSet.add("gull");
lightWeightSet.forEach((value, key) = > {
    console.log("value:" + value, "key:" + key);
});

entries

entries(): IterableIterator<[T, T]>

返回包含此映射中包含的键值对的新迭代器对象。

系统能力: SystemCapability.Utils.Lang

返回值:

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

错误码:

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

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

示例:

let lightWeightSet = new LightWeightSet();
lightWeightSet.add("squirrel");
lightWeightSet.add("sparrow");
let iter = lightWeightSet.entries();
let index = 0;
while(index < lightWeightSet.length) {
  console.log(JSON.stringify(iter.next().value));
  index++;
}

[Symbol.iterator]

HarmonyOSOpenHarmony鸿蒙文档籽料:mau123789是v直接拿

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

Symbol.iterator: IterableIterator

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

系统能力: SystemCapability.Utils.Lang

返回值:

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

错误码:

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

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

示例:

let lightWeightSet = new LightWeightSet();
lightWeightSet.add("squirrel");
lightWeightSet.add("sparrow");

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

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

审核编辑 黄宇

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

    关注

    0

    文章

    10

    浏览量

    8655
  • 鸿蒙
    +关注

    关注

    57

    文章

    2346

    浏览量

    42825
  • OpenHarmony
    +关注

    关注

    25

    文章

    3716

    浏览量

    16275
收藏 人收藏

    评论

    相关推荐

    OpenHarmony语言基础【@ohos.util (util工具函数)】

    ……………………
    的头像 发表于 04-25 17:41 1699次阅读
    <b class='flag-5'>OpenHarmony</b><b class='flag-5'>语言</b>基础<b class='flag-5'>类</b><b class='flag-5'>库</b>【@<b class='flag-5'>ohos.util</b> (<b class='flag-5'>util</b>工具函数)】

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

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

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

    HashMap底层使用数组+链表+红黑树的方式实现,查询、插入和删除的效率都很高。HashMap存储内容基于key-value的键值对映射,不能有重复的key,且一个key只能对应一个value。
    的头像 发表于 04-25 22:12 857次阅读
    <b class='flag-5'>OpenHarmony</b><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)】

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

    LightWeightMap可用于存储具有关联关系的key-value键值对集合,存储元素中key值唯一,每个key对应一个value。
    的头像 发表于 04-26 17:59 977次阅读
    <b class='flag-5'>OpenHarmony</b><b class='flag-5'>语言</b>基础<b class='flag-5'>类</b><b class='flag-5'>库</b>【@<b class='flag-5'>ohos.util</b>.LightWeightMap (<b class='flag-5'>非线性</b><b class='flag-5'>容器</b>LightWeightMap)】

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

    PlainArray可用于存储具有关联关系的key-value键值对集合,存储元素中key值唯一,key值类型为number类型,每个key对应一个value。
    的头像 发表于 05-10 16:31 679次阅读
    <b class='flag-5'>OpenHarmony</b><b class='flag-5'>语言</b>基础<b class='flag-5'>类</b><b class='flag-5'>库</b>【@<b class='flag-5'>ohos.util</b>.PlainArray (<b class='flag-5'>非线性</b><b class='flag-5'>容器</b>PlainArray)】

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

    Vector是一种线性数据结构,底层基于数组实现。当Vector的内存用尽时,会自动分配更大的连续内存区,将原先的元素复制到新的内存区,并释放旧的内存区。使用Vector能够高效快速地访问元素。
    的头像 发表于 04-28 21:24 487次阅读
    <b class='flag-5'>OpenHarmony</b><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)】

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

    HashMap、HashSet、TreeMap、TreeSet、LightWeightMap、LightWeightSet、PlainArray七种。非线性容器中的key及value
    发表于 03-07 11:40

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

    、HashSet、TreeMap、TreeSet、LightWeightMap、LightWeightSet、PlainArray 七种。非线性容器中的 key 及 value 的类
    发表于 04-24 14:58

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

    非线性容器实现能快速查找的数据结构,其底层通过hash或者红黑树实现,包括HashMap、HashSet、TreeMap、TreeSet、LightWeightMap、LightWeightSet
    发表于 09-27 15:18

    HarmonyOS语言基础开发指南上线啦!

    指南中提供了详细的介绍和开发指导,帮助开发者全面了解并发实现、容器基础操作、XML的生成解析与转换等。 本期HarmonyOS开发者资料直通车带您快速了解内容干货~ 一、语言基础
    发表于 10-18 16:36

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

    、LightWeightMap、LightWeightSet、PlainArray 七种。非线性容器中的 key 及 value 的类型均满足 ECMA 标准。 HashMap HashMap 可用来存储具有
    的头像 发表于 02-19 20:23 445次阅读

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

    HashSet基于[HashMap]实现。在HashSet中,只对value对象进行处理。
    的头像 发表于 04-26 15:13 291次阅读
    <b class='flag-5'>OpenHarmony</b><b class='flag-5'>语言</b>基础<b class='flag-5'>类</b><b class='flag-5'>库</b>【@<b class='flag-5'>ohos.util</b>.HashSet (<b class='flag-5'>非线性</b><b class='flag-5'>容器</b>HashSet)】

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

    TreeMap可用于存储具有关联关系的key-value键值对集合,存储元素中key值唯一,每个key对应一个value。
    的头像 发表于 04-28 15:23 294次阅读
    <b class='flag-5'>OpenHarmony</b><b class='flag-5'>语言</b>基础<b class='flag-5'>类</b><b class='flag-5'>库</b>【@<b class='flag-5'>ohos.util</b>.TreeMap (<b class='flag-5'>非线性</b><b class='flag-5'>容器</b>TreeMap)】

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

    TreeSet基于[TreeMap]实现,在TreeSet中,只对value对象进行处理。TreeSet可用于存储一系列值的集合,元素中value唯一且有序。
    的头像 发表于 04-28 18:02 532次阅读
    <b class='flag-5'>OpenHarmony</b><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.TreeSet 非线性容器TreeSet

    TreeSet基于[TreeMap]实现,在TreeSet中,只对value对象进行处理。TreeSet可用于存储一系列值的集合,元素中value唯一且有序。
    的头像 发表于 07-11 16:25 329次阅读
    鸿蒙<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