LightWeightSet可用于存儲一系列值的集合,存儲元素中value值唯一。
LightWeightSet依據泛型定義,采用輕量級結構,初始默認容量大小為8,每次擴容大小為原始容量的兩倍。
集合中value值的查找依賴于hash算法,通過一個數組存儲hash值,然后映射到其他數組中的value值。
LightWeightSet和[HashSet]都是用來存儲鍵值的集合,LightWeightSet的占用內存更小。
推薦使用場景: 當需要存取某個集合或是對某個集合去重時,推薦使用占用內存更小的LightWeightSet。
文檔中存在泛型的使用,涉及以下泛型標記符:
- T:Type,類
說明:
導入模塊
import LightWeightSet from '@ohos.util.LightWeightSet';
LightWeightSet
屬性
系統能力: SystemCapability.Utils.Lang
名稱 | 類型 | 可讀 | 可寫 | 說明 |
---|---|---|---|---|
length | number | 是 | 否 | LightWeightSet的元素個數。 |
鴻蒙開發指導文檔:[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]點擊或者復制轉到。
constructor
constructor()
LightWeightSet的構造函數。
系統能力: SystemCapability.Utils.Lang
錯誤碼:
以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]。
錯誤碼ID | 錯誤信息 |
---|---|
10200012 | The LightWeightSet's constructor cannot be directly invoked. |
示例:
let lightWeightSet = new LightWeightSet();
isEmpty
isEmpty(): boolean
判斷該容器是否為空。
系統能力: SystemCapability.Utils.Lang
返回值:
類型 | 說明 |
---|---|
boolean | 為空返回true,不為空返回false。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]。
錯誤碼ID | 錯誤信息 |
---|---|
10200011 | The isEmpty method cannot be bound. |
示例:
const lightWeightSet = new LightWeightSet();
let result = lightWeightSet.isEmpty();
add
add(obj: T): boolean
向此容器中添加數據。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類型 | 必填 | 說明 |
---|---|---|---|
obj | T | 是 | 添加的成員數據。 |
返回值:
類型 | 說明 |
---|---|
boolean | 成功添加元素返回true,否則返回false。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]。
錯誤碼ID | 錯誤信息 |
---|---|
10200011 | The add method cannot be bound. |
示例:
let lightWeightSet = new LightWeightSet();
let result = lightWeightSet.add("squirrel");
addAll
addAll(set: LightWeightSet): boolean
將另一個容器中的所有元素組添加到當前容器中。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類型 | 必填 | 說明 |
---|---|---|---|
set | LightWeightSet | 是 | 提供添加元素的lightWeightSet。 |
返回值:
類型 | 說明 |
---|---|
boolean | 成功添加元素返回true,否則返回false。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]。
錯誤碼ID | 錯誤信息 |
---|---|
10200011 | The 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
參數:
參數名 | 類型 | 必填 | 說明 |
---|---|---|---|
set | LightWeightSet | 是 | 比較對象。 |
返回值:
類型 | 說明 |
---|---|
boolean | 包含所有元素返回true,否則返回false。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]。
錯誤碼ID | 錯誤信息 |
---|---|
10200011 | The 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
參數:
參數名 | 類型 | 必填 | 說明 |
---|---|---|---|
key | T | 是 | 指定key |
返回值:
類型 | 說明 |
---|---|
boolean | 包含指定key返回true,否則返回false。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]。
錯誤碼ID | 錯誤信息 |
---|---|
10200011 | The 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
參數:
參數名 | 類型 | 必填 | 說明 |
---|---|---|---|
obj | Object | 是 | 比較對象。 |
返回值:
類型 | 說明 |
---|---|
boolean | 構成類型相同返回true,否則返回false。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]。
錯誤碼ID | 錯誤信息 |
---|---|
10200011 | The 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
參數:
參數名 | 類型 | 必填 | 說明 |
---|---|---|---|
minimumCapacity | number | 是 | 需要容納數量。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]
錯誤碼ID | 錯誤信息 |
---|---|
10200011 | The increaseCapacityTo method cannot be bound. |
10200001 | The value of minimumCapacity is out of range. |
示例:
let lightWeightSet = new LightWeightSet();
lightWeightSet.increaseCapacityTo(10);
getIndexOf
getIndexOf(key: T): number
獲取指定key所對應的下標。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類型 | 必填 | 說明 |
---|---|---|---|
key | T | 是 | 查找的指定key。 |
返回值:
類型 | 說明 |
---|---|
number | 在lightWeightSet中指定數據的下標。若lightWeightSet中沒有要查找的元素,則返回一個負值。表示目標哈希值應該插入的位置,插入位置是從1開始計數的,負號表示這是一個插入位置而不是索引。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]
錯誤碼ID | 錯誤信息 |
---|---|
10200011 | The 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
參數:
參數名 | 類型 | 必填 | 說明 |
---|---|---|---|
key | T | 是 | 指定key。 |
返回值:
類型 | 說明 |
---|---|
T | 返回刪除元素的值。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]
錯誤碼ID | 錯誤信息 |
---|---|
10200011 | The 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
參數:
參數名 | 類型 | 必填 | 說明 |
---|---|---|---|
index | number | 是 | 指定下標。 |
返回值:
類型 | 說明 |
---|---|
boolean | 確認是否成功刪除元素,成功刪除元素返回true,否則返回false。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]
錯誤碼ID | 錯誤信息 |
---|---|
10200011 | The 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
參數:
參數名 | 類型 | 必填 | 說明 |
---|---|---|---|
index | number | 是 | 指定下標。 |
返回值:
類型 | 說明 |
---|---|
T | 返回指定下標對應的元素。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]
錯誤碼ID | 錯誤信息 |
---|---|
10200011 | The 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 | 錯誤信息 |
---|---|
10200011 | The 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 | 錯誤信息 |
---|---|
10200011 | The 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 | 錯誤信息 |
---|---|
10200011 | The 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
參數:
參數名 | 類型 | 必填 | 說明 |
---|---|---|---|
callbackFn | function | 是 | 回調函數。 |
thisArg | Object | 否 | callbackfn被調用時用作this值。 |
callbackfn的參數說明:
參數名 | 類型 | 必填 | 說明 |
---|---|---|---|
value | T | 否 | 當前遍歷到的元素。 |
key | T | 否 | 當前遍歷到的元素(和value相同)。 |
set | LightWeightSet | 否 | 當前調用forEach方法的實例對象。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]。
錯誤碼ID | 錯誤信息 |
---|---|
10200011 | The 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 | 錯誤信息 |
---|---|
10200011 | The 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]
HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿
Symbol.iterator: IterableIterator
返回一個迭代器,迭代器的每一項都是一個 JavaScript 對象,并返回該對象。
系統能力: SystemCapability.Utils.Lang
返回值:
類型 | 說明 |
---|---|
IterableIterator | 返回一個迭代器。 |
錯誤碼:
以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]。
錯誤碼ID | 錯誤信息 |
---|---|
10200011 | The 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瀏覽量
8657 -
鴻蒙
+關注
關注
57文章
2347瀏覽量
42827 -
OpenHarmony
+關注
關注
25文章
3718瀏覽量
16289
發布評論請先 登錄
相關推薦
評論