線性容器ArrayList

2024-01-23 18:12 更新
說明

本模塊首批接口從API version 8開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。

ArrayList是一種線性數(shù)據(jù)結(jié)構(gòu)，底層基于數(shù)組實(shí)現(xiàn)。ArrayList會根據(jù)實(shí)際需要動態(tài)調(diào)整容量，每次擴(kuò)容增加50%。

ArrayList和Vector相似，都是基于數(shù)組實(shí)現(xiàn)。它們都可以動態(tài)調(diào)整容量，但Vector每次擴(kuò)容增加1倍。

ArrayList和LinkedList相比，ArrayList的隨機(jī)訪問效率更高。但由于ArrayList的增刪操作會影響數(shù)組內(nèi)其他元素的移動，LinkedList的增加和刪除操作效率更高。

推薦使用場景： 當(dāng)需要頻繁讀取集合中的元素時，推薦使用ArrayList。

文檔中存在泛型的使用,涉及以下泛型標(biāo)記符:

  • T: Type, 類

導(dǎo)入模塊

  1. import ArrayList from '@ohos.util.ArrayList';

ArrayList

屬性

系統(tǒng)能力： SystemCapability.Utils.Lang

名稱類型可讀可寫說明
lengthnumber是否ArrayList的元素個數(shù)。

constructor

constructor()

ArrayList的構(gòu)造函數(shù)。

系統(tǒng)能力： SystemCapability.Utils.Lang

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200012The ArrayList's constructor cannot be directly invoked.

示例：

  1. let arrayList = new ArrayList();

add

add(element: T): boolean

在ArrayList尾部插入元素。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

參數(shù)名類型必填說明
elementT是待插入的元素。

返回值：

類型說明
boolean插入成功返回true，失敗返回false。

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The add method cannot be bound.

示例：

  1. let arrayList = new ArrayList();
  2. let result = arrayList.add("a");
  3. let result1 = arrayList.add(1);
  4. let b = [1, 2, 3];
  5. let result2 = arrayList.add(b);
  6. let c = {name: "Dylon", age: "13"};
  7. let result3 = arrayList.add(c);
  8. let result4 = arrayList.add(false);

insert

insert(element: T, index: number): void

在長度范圍內(nèi)任意位置插入指定元素。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

參數(shù)名類型必填說明
elementT是被插入的元素。
indexnumber是被插入的位置索引。

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The insert method cannot be bound.
10200001The value of index is out of range.

示例：

  1. let arrayList = new ArrayList();
  2. arrayList.insert("A", 0);
  3. arrayList.insert(0, 1);
  4. arrayList.insert(true, 2);

has

has(element: T): boolean

判斷此ArrayList中是否含有該指定元素。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

參數(shù)名類型必填說明
elementT是指定元素。

返回值：

類型說明
boolean返回true表示包含指定元素，否則返回false。

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The has method cannot be bound.

示例：

  1. let arrayList = new ArrayList();
  2. let result = arrayList.has("squirrel");
  3. arrayList.add("squirrel");
  4. let result1 = arrayList.has("squirrel");

getIndexOf

getIndexOf(element: T): number

返回指定元素第一次出現(xiàn)時的下標(biāo)值，查找失敗返回-1。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

參數(shù)名類型必填說明
elementT是指定元素。

返回值：

類型說明
number返回指定元素第一次出現(xiàn)時的下標(biāo)值，查找失敗返回-1。

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The getIndexOf method cannot be bound.

示例：

  1. let arrayList = new ArrayList();
  2. arrayList.add(2);
  3. arrayList.add(4);
  4. arrayList.add(5);
  5. arrayList.add(2);
  6. arrayList.add(1);
  7. arrayList.add(2);
  8. arrayList.add(4);
  9. let result = arrayList.getIndexOf(2);

getLastIndexOf

getLastIndexOf(element: T): number

返回指定元素最后一次出現(xiàn)時的下標(biāo)值，查找失敗返回-1。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

參數(shù)名類型必填說明
elementT是指定元素。

返回值：

類型說明
number返回指定元素最后一次出現(xiàn)時的下標(biāo)值，查找失敗返回-1。

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The getLastIndexOf method cannot be bound.

示例：

  1. let arrayList = new ArrayList();
  2. arrayList.add(2);
  3. arrayList.add(4);
  4. arrayList.add(5);
  5. arrayList.add(2);
  6. arrayList.add(1);
  7. arrayList.add(2);
  8. arrayList.add(4);
  9. let result = arrayList.getLastIndexOf(2);

removeByIndex

removeByIndex(index: number): T

根據(jù)元素的下標(biāo)值查找元素，返回元素后將其刪除。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

參數(shù)名類型必填說明
indexnumber是指定元素的下標(biāo)值。

返回值：

類型說明
T返回刪除的元素。

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The removeByIndex method cannot be bound.
10200001The value of index is out of range.

示例：

  1. let arrayList = new ArrayList();
  2. arrayList.add(2);
  3. arrayList.add(4);
  4. arrayList.add(5);
  5. arrayList.add(2);
  6. arrayList.add(4);
  7. let result = arrayList.removeByIndex(2);

remove

remove(element: T): boolean

刪除查找到的第一個指定的元素。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

參數(shù)名類型必填說明
elementT是指定元素。

返回值：

類型說明
boolean刪除成功返回true，失敗返回false。

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The remove method cannot be bound.

示例：

  1. let arrayList = new ArrayList();
  2. arrayList.add(2);
  3. arrayList.add(4);
  4. arrayList.add(5);
  5. arrayList.add(4);
  6. let result = arrayList.remove(2);

removeByRange

removeByRange(fromIndex: number, toIndex: number): void

從一段范圍內(nèi)刪除元素，包括起始值但不包括終止值。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

參數(shù)名類型必填說明
fromIndexnumber是起始下標(biāo)。
toIndexnumber是終止下標(biāo)。

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The removeByRange method cannot be bound.
10200001The value of fromIndex or toIndex is out of range.

示例：

  1. let arrayList = new ArrayList();
  2. arrayList.add(2);
  3. arrayList.add(4);
  4. arrayList.add(5);
  5. arrayList.add(4);
  6. arrayList.removeByRange(2, 4);

replaceAllElements

replaceAllElements(callbackFn: (value: T, index?: number, arrlist?: ArrayList<T>) => T,

thisArg?: Object): void

用戶操作ArrayList中的元素，用操作后的元素替換原元素并返回操作后的元素。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

參數(shù)名類型必填說明
callbackFnfunction是回調(diào)函數(shù)。
thisArgObject否callbackfn被調(diào)用時用作this值。

callbackfn的參數(shù)說明：

參數(shù)名類型必填說明
valueT是當(dāng)前遍歷到的元素。
indexnumber否當(dāng)前遍歷到的下標(biāo)值。
arrlistArrayList<T>否當(dāng)前調(diào)用replaceAllElements方法的實(shí)例對象。

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The replaceAllElements method cannot be bound.

示例：

  1. let arrayList = new ArrayList();
  2. arrayList.add(2);
  3. arrayList.add(4);
  4. arrayList.add(5);
  5. arrayList.add(4);
  6. arrayList.replaceAllElements((value) => {
  7.     // 用戶操作邏輯根據(jù)實(shí)際場景進(jìn)行添加。
  8.     return value;
  9. });

forEach

forEach(callbackFn: (value: T, index?: number, arrlist?: ArrayList<T>) => void,

thisArg?: Object): void

通過回調(diào)函數(shù)來遍歷ArrayList實(shí)例對象上的元素以及元素對應(yīng)的下標(biāo)。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

參數(shù)名類型必填說明
callbackFnfunction是回調(diào)函數(shù)。
thisArgObject否callbackfn被調(diào)用時用作this值。

callbackfn的參數(shù)說明：

參數(shù)名類型必填說明
valueT是當(dāng)前遍歷到的元素。
indexnumber否當(dāng)前遍歷到的下標(biāo)值。
arrlistArrayList<T>否當(dāng)前調(diào)用forEach方法的實(shí)例對象。

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The forEach method cannot be bound.

示例：

  1. let arrayList = new ArrayList();
  2. arrayList.add(2);
  3. arrayList.add(4);
  4. arrayList.add(5);
  5. arrayList.add(4);
  6. arrayList.forEach((value, index) => {
  7.     console.log("value:" + value, "index:" + index);
  8. });

sort

sort(comparator?: (firstValue: T, secondValue: T) => number): void

對ArrayList中的元素排序。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

參數(shù)名類型必填說明
comparatorfunction否回調(diào)函數(shù)。

comparator的參數(shù)說明：

參數(shù)名類型必填說明
firstValueT是前一項(xiàng)元素。
secondValueT是后一項(xiàng)元素。

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The sort method cannot be bound.

示例：

  1. let arrayList = new ArrayList();
  2. arrayList.add(2);
  3. arrayList.add(4);
  4. arrayList.add(5);
  5. arrayList.add(4);
  6. arrayList.sort((a: number, b: number) => a - b);
  7. arrayList.sort((a: number, b: number) => b - a);
  8. arrayList.sort();

subArrayList

subArrayList(fromIndex: number, toIndex: number): ArrayList<T>

根據(jù)下標(biāo)截取ArrayList中的一段元素，并返回這一段ArrayList實(shí)例，包括起始值但不包括終止值。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

參數(shù)名類型必填說明
fromIndexnumber是起始下標(biāo)。
toIndexnumber是終止下標(biāo)。

返回值：

類型說明
ArrayList<T>返回ArrayList對象實(shí)例。

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The subArrayList method cannot be bound.
10200001The value of fromIndex or toIndex is out of range.

示例：

  1. let arrayList = new ArrayList();
  2. arrayList.add(2);
  3. arrayList.add(4);
  4. arrayList.add(5);
  5. arrayList.add(4);
  6. let result1 = arrayList.subArrayList(2, 4);
  7. let result2 = arrayList.subArrayList(4, 3);
  8. let result3 = arrayList.subArrayList(2, 6);

clear

clear(): void

清除ArrayList中的所有元素，并把length置為0。

系統(tǒng)能力： SystemCapability.Utils.Lang

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The clear method cannot be bound.

示例：

  1. let arrayList = new ArrayList();
  2. arrayList.add(2);
  3. arrayList.add(4);
  4. arrayList.add(5);
  5. arrayList.add(4);
  6. arrayList.clear();

clone

clone(): ArrayList<T>

克隆一個與ArrayList相同的實(shí)例，并返回克隆后的實(shí)例。修改克隆后的實(shí)例并不會影響原實(shí)例。

系統(tǒng)能力： SystemCapability.Utils.Lang

返回值：

類型說明
ArrayList<T>返回ArrayList對象實(shí)例。

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The clone method cannot be bound.

示例：

  1. let arrayList = new ArrayList();
  2. arrayList.add(2);
  3. arrayList.add(4);
  4. arrayList.add(5);
  5. arrayList.add(4);
  6. let result = arrayList.clone();

getCapacity

getCapacity(): number

獲取當(dāng)前實(shí)例的容量大小。

系統(tǒng)能力： SystemCapability.Utils.Lang

返回值：

類型說明
number返回arraylist的容量大小。

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The getCapacity method cannot be bound.

示例：

  1. let arrayList = new ArrayList();
  2. arrayList.add(2);
  3. arrayList.add(4);
  4. arrayList.add(5);
  5. arrayList.add(4);
  6. let result = arrayList.getCapacity();

convertToArray

convertToArray(): Array<T>

把當(dāng)前ArrayList實(shí)例轉(zhuǎn)換成數(shù)組，并返回轉(zhuǎn)換后的數(shù)組。

系統(tǒng)能力： SystemCapability.Utils.Lang

返回值：

類型說明
Array<T>返回數(shù)組類型。

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The convertToArray method cannot be bound.

示例：

  1. let arrayList = new ArrayList();
  2. arrayList.add(2);
  3. arrayList.add(4);
  4. arrayList.add(5);
  5. arrayList.add(4);
  6. let result = arrayList.convertToArray();

isEmpty

isEmpty(): boolean

判斷該ArrayList是否為空。

系統(tǒng)能力： SystemCapability.Utils.Lang

返回值：

類型說明
boolean為空返回true，不為空返回false。

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The isEmpty method cannot be bound.

示例：

  1. let arrayList = new ArrayList();
  2. arrayList.add(2);
  3. arrayList.add(4);
  4. arrayList.add(5);
  5. arrayList.add(4);
  6. let result = arrayList.isEmpty();

increaseCapacityTo

increaseCapacityTo(newCapacity: number): void

如果傳入的新容量大于或等于ArrayList中的元素個數(shù)，將容量變更為新容量。

系統(tǒng)能力： SystemCapability.Utils.Lang

參數(shù)：

參數(shù)名類型必填說明
newCapacitynumber是新容量。

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The increaseCapacityTo method cannot be bound.

示例：

  1. let arrayList = new ArrayList();
  2. arrayList.add(2);
  3. arrayList.add(4);
  4. arrayList.add(5);
  5. arrayList.add(4);
  6. arrayList.increaseCapacityTo(2);
  7. arrayList.increaseCapacityTo(8);

trimToCurrentLength

trimToCurrentLength(): void

把容量限制為當(dāng)前的length大小。

系統(tǒng)能力： SystemCapability.Utils.Lang

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The trimToCurrentLength method cannot be bound.

示例：

  1. let arrayList = new ArrayList();
  2. arrayList.add(2);
  3. arrayList.add(4);
  4. arrayList.add(5);
  5. arrayList.add(4);
  6. arrayList.trimToCurrentLength();

[Symbol.iterator]

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

返回一個迭代器，迭代器的每一項(xiàng)都是一個 JavaScript 對象，并返回該對象。

系統(tǒng)能力： SystemCapability.Utils.Lang

返回值：

類型說明
IterableIterator<T>返回一個迭代器。

錯誤碼：

以下錯誤碼的詳細(xì)介紹請參見語言基礎(chǔ)類庫錯誤碼。

錯誤碼ID錯誤信息
10200011The Symbol.iterator method cannot be bound.

示例：

  1. let arrayList = new ArrayList();
  2. arrayList.add(2);
  3. arrayList.add(4);
  4. arrayList.add(5);
  5. arrayList.add(4);
  6. 

  7. // 使用方法一：
  8. for (let item of arrayList) { 
  9.     console.log(`value:${item}`); 
  10. } 
  11. 

  12. // 使用方法二：
  13. let iter = arrayList[Symbol.iterator]();
  14. let temp = iter.next().value;
  15. while(temp != undefined) {
  16.     console.log(`value:${temp}`);
  17.     temp = iter.next().value;
  18. }
以上內(nèi)容是否對您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號