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

Stack基于數組的數據結構實現，特點是先進后出，只能在一端進行數據的插入和刪除。

Stack和[Queue]相比，Queue基于循環隊列實現，只能在一端刪除，另一端插入，而Stack都在一端操作。

推薦使用場景： 一般符合先進后出的場景可以使用Stack。

文檔中存在泛型的使用，涉及以下泛型標記符：

• T：Type，類

說明：

本模塊首批接口從API version 8開始支持。后續版本的新增接口，采用上角標單獨標記接口的起始版本。

導入模塊

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

Stack

屬性

系統能力： SystemCapability.Utils.Lang

鴻蒙開發指導文檔：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]點擊或者復制轉到。

constructor

constructor()

Stack的構造函數。

系統能力： SystemCapability.Utils.Lang

錯誤碼：

以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]。

示例：

let stack = new Stack();

push

push(item: T): T

在棧頂插入元素，并返回該元素。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]。

示例：

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

pop

pop(): T

刪除棧頂元素并返回該元素，棧為空時返回undefined。

系統能力： SystemCapability.Utils.Lang

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]。

示例：

let stack = new Stack();
stack.push(2);
stack.push(4);
stack.push(5);
stack.push(2);
stack.push(4);
let result = stack.pop();

peek

peek(): T

獲取并返回棧頂元素。

系統能力： SystemCapability.Utils.Lang

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]。

示例：

let stack = new Stack();
stack.push(2);
stack.push(4);
stack.push(5);
stack.push(2);
let result = stack.peek();

locate

locate(element: T): number

返回指定元素第一次出現時的下標值，查找失敗返回-1。

系統能力： SystemCapability.Utils.Lang

參數：

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]。

示例：

let stack = new Stack();
stack.push(2);
stack.push(4);
stack.push(5);
stack.push(2);
let result = stack.locate(2);

forEach

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

通過回調函數來遍歷Stack實例對象上的元素以及元素對應的下標。

系統能力： SystemCapability.Utils.Lang

參數：

callbackfn的參數說明：

錯誤碼：

以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]。

示例：

let stack = new Stack();
stack.push(2);
stack.push(4);
stack.push(5);
stack.push(4);
stack.forEach((value, index) = > {
    console.log("value:" + value, "index:" + index);
});

isEmpty

isEmpty(): boolean

判斷該棧是否為空。

系統能力： SystemCapability.Utils.Lang

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]

示例：

let stack = new Stack();
stack.push(2);
stack.push(4);
stack.push(5);
stack.push(4);
let result = stack.isEmpty();
    
`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

[Symbol.iterator]

Symbol.iterator: IterableIterator

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

系統能力： SystemCapability.Utils.Lang

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見[語言基礎類庫錯誤碼]

示例：

let stack = new Stack();
stack.push(2);
stack.push(4);
stack.push(5);
stack.push(4);

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

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

審核編輯 黃宇