Vector是一種線(xiàn)性數據結構,底層基于數組實(shí)現。當Vector的內存用盡時(shí),會(huì )自動(dòng)分配更大的連續內存區,將原先的元素復制到新的內存區,并釋放舊的內存區。使用Vector能夠高效快速地訪(fǎng)問(wèn)元素。
Vector和[ArrayList]相似,都是基于數組實(shí)現,但Vector提供了更多操作數組的接口。它們都可以動(dòng)態(tài)調整容量,但Vector每次擴容增加1倍,ArrayList只擴容0.5倍。
推薦使用場(chǎng)景: 當數據量大時(shí),一般使用Vector來(lái)存取數據。
文檔中存在泛型的使用,涉及以下泛型標記符:
- T:Type,類(lèi)
說(shuō)明:
本模塊首批接口從API version 8開(kāi)始支持。后續版本的新增接口,采用上角標單獨標記接口的起始版本。
API version 9開(kāi)始,該接口不再維護,推薦使用接口['@ohos.util.ArrayList']。
導入模塊
import Vector from '@ohos.util.Vector';
Vector
屬性
系統能力: SystemCapability.Utils.Lang
名稱(chēng) | 類(lèi)型 | 可讀 | 可寫(xiě) | 說(shuō)明 |
---|---|---|---|---|
length | number | 是 | 否 | Vector的元素個(gè)數。 |
鴻蒙開(kāi)發(fā)指導文檔:[qr23.cn/FBD4cY
]
constructor
constructor()
Vector的構造函數。
系統能力: SystemCapability.Utils.Lang
示例:
let vector = new Vector();
add
add(element: T): boolean
在Vector中尾部插入元素。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
element | T | 是 | 添加進(jìn)去的元素。 |
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
boolean | 插入成功返回true,失敗返回false。 |
示例:
let vector = new Vector();
let result = vector.add("a");
let result1 = vector.add(1);
let b = [1, 2, 3];
let result2 = vector.add(b);
let c = {name : "Dylon", age : "13"};
let result3 = vector.add(c);
insert
insert(element: T, index: number): void
在長(cháng)度范圍內任意插入指定元素,并將其后續元素向右移動(dòng)。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
element | T | 是 | 被插入的元素。 |
index | number | 是 | 被插入的位置索引。 |
示例:
let vector = new Vector();
vector.insert("A", 0);
vector.insert(0, 1);
vector.insert(true, 2);
has
has(element: T): boolean
判斷此Vector中是否含有該指定元素。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
element | T | 是 | 指定的元素。 |
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
boolean | 是否包含指定元素,true表示包含該元素,false表示不包含。 |
示例:
let vector = new Vector();
let result = vector.has("squirrel");
vector.add("squirrel");
let result1 = vector.has("squirrel");
getIndexOf
getIndexOf(element: T): number
返回指定元素第一次出現時(shí)的下標值,查找失敗返回-1。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
element | T | 是 | 指定的元素。 |
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
number | 返回指定元素第一次出現時(shí)的下標值,查找失敗返回-1。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(2);
vector.add(1);
vector.add(2);
vector.add(4);
let result = vector.getIndexOf(2);
getLastIndexOf
getLastIndexOf(element: T): number
返回指定元素最后一次出現時(shí)的下標值,查找失敗返回-1。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
element | T | 是 | 指定元素。 |
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
number | 返回指定元素最后一次出現時(shí)的下標值,查找失敗返回-1。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(2);
vector.add(1);
vector.add(2);
vector.add(4);
let result = vector.getLastIndexOf(2);
removeByIndex
removeByIndex(index: number): T
根據元素的下標值查找元素,返回元素后將其刪除,并將其后續元素向左移動(dòng)。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
index | number | 是 | 指定元素的下標值。 |
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
T | 返回被刪除的元素。數組為空時(shí)返回undefined,下標越界時(shí)拋出異常。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(2);
vector.add(4);
let result = vector.removeByIndex(2);
remove
remove(element: T): boolean
刪除查找到的第一個(gè)指定的元素。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
element | T | 是 | 指定元素。 |
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
boolean | 刪除成功返回true,否則返回false。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
let result = vector.remove(2);
removeByRange
removeByRange(fromIndex: number, toIndex: number): void
從一段范圍內刪除元素,包括起始值但不包括終止值。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
fromIndex | number | 是 | 起始下標。 |
toIndex | number | 是 | 終止下標。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
vector.removeByRange(2,4);
replaceAllElements
replaceAllElements(callbackFn: (value: T, index?: number, vector?: Vector) => T, thisArg?: Object): void
用戶(hù)操作Vector中的元素,用操作后的元素替換原元素并返回操作后的元素。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
callbackFn | function | 是 | 回調函數。 |
thisArg | Object | 否 | callbackfn被調用時(shí)用作this值。 |
callbackfn的參數說(shuō)明:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
value | T | 是 | 當前遍歷到的元素。 |
index | number | 否 | 當前遍歷到的下標值。 |
vector | Vector | 否 | 當前調用replaceAllElements方法的實(shí)例對象。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
vector.replaceAllElements((value) = > {
// 用戶(hù)操作邏輯根據實(shí)際場(chǎng)景進(jìn)行添加。
return value;
});
forEach
forEach(callbackFn: (value: T, index?: number, vector?: Vector) => void, thisArg?: Object): void
通過(guò)回調函數來(lái)遍歷Vector實(shí)例對象上的元素以及元素對應的下標。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
callbackFn | function | 是 | 回調函數。 |
thisArg | Object | 否 | callbackfn被調用時(shí)用作this值。 |
callbackfn的參數說(shuō)明:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
value | T | 是 | 當前遍歷到的元素。 |
index | number | 否 | 當前遍歷到的下標值。 |
vector | Vector | 否 | 當前調用forEach方法的實(shí)例對象。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
vector.forEach((value, index) = > {
console.log("value:" + value, "index:" + index);
});
sort
sort(comparator?: (firstValue: T, secondValue: T) => number): void
對Vector中的元素進(jìn)行一個(gè)排序操作。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
comparator | function | 否 | 回調函數。 |
comparator的參數說(shuō)明:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
firstValue | T | 是 | 前一項元素。 |
secondValue | T | 是 | 后一項元素。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
vector.sort((a: number, b: number) = > a - b);
vector.sort((a: number, b: number) = > b - a);
vector.sort();
subVector
subVector(fromIndex: number, toIndex: number): Vector
根據下標截取Vector中的一段元素,并返回這一段vector實(shí)例,包括起始值但不包括終止值。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
fromIndex | number | 是 | 起始下標。 |
toIndex | number | 是 | 終止下標。 |
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
Vector | 返回Vector對象實(shí)例。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
vector.add(6);
vector.add(8);
let result = vector.subVector(0,4);
let result1 = vector.subVector(2,4);
clear
clear(): void
清除Vector中的所有元素,并把length置為0。
系統能力: SystemCapability.Utils.Lang
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
vector.clear();
clone
clone(): Vector
克隆一個(gè)與Vector相同的實(shí)例,并返回克隆后的實(shí)例。修改克隆后的實(shí)例并不會(huì )影響原實(shí)例。
系統能力: SystemCapability.Utils.Lang
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
Vector | 返回Vector對象實(shí)例。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
let result = vector.clone();
getCapacity
getCapacity(): number
獲取當前實(shí)例的容量大小。
系統能力: SystemCapability.Utils.Lang
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
number | 返回Vector的容量大小。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
let result = vector.getCapacity();
convertToArray
convertToArray(): Array
把當前Vector實(shí)例轉換成數組,并返回轉換后的數組。
系統能力: SystemCapability.Utils.Lang
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
Array | 返回數組類(lèi)型。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
let result = vector.convertToArray();
isEmpty
isEmpty(): boolean
判斷該Vector是否為空。
系統能力: SystemCapability.Utils.Lang
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
boolean | 為空返回true,否則返回false。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
let result = vector.isEmpty();
increaseCapacityTo
increaseCapacityTo(newCapacity: number): void
如果傳入的新容量大于或等于Vector中的元素個(gè)數,將容量變更為新容量。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
newCapacity | number | 是 | 新容量。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
vector.increaseCapacityTo(2);
vector.increaseCapacityTo(12);
trimToCurrentLength
trimToCurrentLength(): void
把容量限制為當前的length大小。
系統能力: SystemCapability.Utils.Lang
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
vector.trimToCurrentLength();
toString
toString(): string
用","將Vector實(shí)例中的元素按順序拼接成字符串。
系統能力: SystemCapability.Utils.Lang
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
string | 返回對應的字符串。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
let result = vector.toString();
copyToArray
copyToArray(array: Array): void
將Vector實(shí)例中的元素按照下標復制到指定數組。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
array | Array | 是 | 指定數組。 |
getFirstElement
getFirstElement(): T
獲取實(shí)例中的第一個(gè)元素。
系統能力: SystemCapability.Utils.Lang
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
T | 返回第一個(gè)元素。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
let result = vector.getFirstElement();
getLastElement
getLastElement(): T
獲取Vector實(shí)例中的最后一個(gè)元素。
系統能力: SystemCapability.Utils.Lang
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
T | 返回最后一個(gè)元素。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
let result = vector.getLastElement();
getLastIndexFrom
getLastIndexFrom(element: T, index: number): number
從指定索引向后搜索,返回該元素的下標索引。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
element | T | 是 | 要查找的元素。 |
index | number | 是 | 從指定索引開(kāi)始搜索。 |
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
number | 返回該元素的下標,如果查找失敗,則返回-1。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
vector.add("a");
let result = vector.getLastIndexFrom(4,3);
getIndexFrom
getIndexFrom(element: T, index: number): number
從指定索引向前搜索,返回該元素的下標索引。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
element | T | 是 | 要查找的元素。 |
index | number | 是 | 從指定索引開(kāi)始搜索。 |
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
number | 返回該元素的下標,如果查找失敗,則返回 -1。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
vector.add("a");
let result = vector.getIndexFrom(4, 3);
setLength
setLength(newSize: number): void
設置Vector實(shí)例的元素個(gè)數。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
newSize | number | 是 | 設置的新長(cháng)度。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
vector.setLength(8);
vector.setLength(2);
get
get(index: number): T
根據下標值獲取Vector實(shí)例中的元素。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
index | number | 是 | 查找的下標值。 |
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
T | 返回獲取到的元素。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
let result = vector.get(2);
set
set(index: number, element: T): T
將此Vector中指定位置的元素替換為指定元素。
系統能力: SystemCapability.Utils.Lang
參數:
參數名 | 類(lèi)型 | 必填 | 說(shuō)明 |
---|---|---|---|
index | number | 是 | 查找的下標值。 |
element | T | 是 | 用來(lái)替換的元素。 |
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
T | 返回替換后的元素。 |
HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿
[Symbol.iterator]
Symbol.iterator: IterableIterator
返回一個(gè)迭代器,迭代器的每一項都是一個(gè) JavaScript 對象,并返回該對象。
系統能力: SystemCapability.Utils.Lang
返回值:
類(lèi)型 | 說(shuō)明 |
---|---|
IterableIterator | 返回一個(gè)迭代器。 |
示例:
let vector = new Vector();
vector.add(2);
vector.add(4);
vector.add(5);
vector.add(4);
// 使用方法一:
for (let item of vector) {
console.log("value:" + item);
}
// 使用方法二:
let iter = vector[Symbol.iterator]();
let temp = iter.next().value;
while(temp != undefined) {
console.log("value:" + temp);
temp = iter.next().value;
}
審核編輯 黃宇
-
接口
+關(guān)注
關(guān)注
33文章
7897瀏覽量
149109 -
Vector
+關(guān)注
關(guān)注
3文章
48瀏覽量
8462 -
鴻蒙
+關(guān)注
關(guān)注
55文章
1977瀏覽量
42225 -
OpenHarmony
+關(guān)注
關(guān)注
24文章
3443瀏覽量
15333
發(fā)布評論請先 登錄
相關(guān)推薦
評論