@ohos.util.Queue (線性容器Queue)

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，類

說明：

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

導(dǎo)入模塊

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

Queue

屬性

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

constructor

constructor()

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

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

錯誤碼：

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

示例：

let queue = new Queue();

add

add(element: T): boolean

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

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

參數(shù)：

返回值：

錯誤碼：

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

示例：

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

pop

pop(): T

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

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

返回值：

錯誤碼：

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

示例：

let queue = new Queue();
queue.add(2);
queue.add(4);
queue.add(5);
queue.add(2);
queue.add(4);
let result = queue.pop();

getFirst

getFirst(): T

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

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

返回值：

錯誤碼：

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

示例：

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

forEach

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

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

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

參數(shù)：

callbackfn的參數(shù)說明：

錯誤碼：

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

示例：

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

鴻蒙開發(fā)指導(dǎo)文檔：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

[Symbol.iterator]

Symbol.iterator: IterableIterator

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

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

返回值：

錯誤碼：

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

示例：

let queue = new Queue();
queue.add(2);
queue.add(4);
queue.add(5);
queue.add(4);

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

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

審核編輯 黃宇