線性容器Queue

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

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

Queue的特點(diǎn)是先進(jìn)先出,在尾部增加元素,在頭部刪除元素。根據(jù)循環(huán)隊(duì)列的數(shù)據(jù)結(jié)構(gòu)實(shí)現(xiàn)。

Queue和Deque相比,Queue只能在一端刪除一端增加,Deque可以兩端增刪。

推薦使用場景: 一般符合先進(jìn)先出的場景可以使用Queue。

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

  • T: Type, 類

導(dǎo)入模塊

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

Queue

屬性

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

名稱類型可讀可寫說明
lengthnumberQueue的元素個(gè)數(shù)。

constructor

constructor()

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

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

錯(cuò)誤碼:

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

錯(cuò)誤碼ID錯(cuò)誤信息
10200012The Queue's constructor cannot be directly invoked.

示例:

  1. let queue = new Queue();

add

add(element: T): boolean

在隊(duì)列尾部插入元素。

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

參數(shù):

參數(shù)名類型必填說明
elementT添加進(jìn)去的元素。

返回值:

類型說明
boolean插入成功返回true,否則返回false。

錯(cuò)誤碼:

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

錯(cuò)誤碼ID錯(cuò)誤信息
10200011The add method cannot be bound.

示例:

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

pop

pop(): T

刪除頭元素并返回該刪除元素。

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

返回值:

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

錯(cuò)誤碼:

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

錯(cuò)誤碼ID錯(cuò)誤信息
10200011The pop method cannot be bound.

示例:

  1. let queue = new Queue();
  2. queue.add(2);
  3. queue.add(4);
  4. queue.add(5);
  5. queue.add(2);
  6. queue.add(4);
  7. let result = queue.pop();

getFirst

getFirst(): T

獲取隊(duì)列的頭元素。

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

返回值:

類型說明
T返回獲取的元素。

錯(cuò)誤碼:

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

錯(cuò)誤碼ID錯(cuò)誤信息
10200011The getFirst method cannot be bound.

示例:

  1. let queue = new Queue();
  2. queue.add(2);
  3. queue.add(4);
  4. queue.add(5);
  5. queue.add(2);
  6. let result = queue.getFirst();

forEach

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

thisArg?: Object): void

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

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

參數(shù):

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

callbackfn的參數(shù)說明:

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

錯(cuò)誤碼:

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

錯(cuò)誤碼ID錯(cuò)誤信息
10200011The forEach method cannot be bound.

示例:

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

[Symbol.iterator]

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

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

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

返回值:

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

錯(cuò)誤碼:

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

錯(cuò)誤碼ID錯(cuò)誤信息
10200011The Symbol.iterator method cannot be bound.

示例:

  1. let queue = new Queue();
  2. queue.add(2);
  3. queue.add(4);
  4. queue.add(5);
  5. queue.add(4);
  6. // 使用方法一:
  7. for (let item of queue) {
  8. console.log("value:" + item);
  9. }
  10. // 使用方法二:
  11. let iter = queue[Symbol.iterator]();
  12. let temp = iter.next().value;
  13. while(temp != undefined) {
  14. console.log("value:" + temp);
  15. temp = iter.next().value;
  16. }
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號