OpenHarmony语言基础类库【@ohos.util.Stack (线性容器Stack)】
@ohos.util.Stack (线性容器Stack)
Stack基于数组的数据结构实现,特点是先进后出,只能在一端进行数据的插入和删除。
Stack和[Queue]相比,Queue基于循环队列实现,只能在一端删除,另一端插入,而Stack都在一端操作。
推荐使用场景:一般符合先进后出的场景可以使用Stack。
文档中存在泛型的使用,涉及以下泛型标记符:
- T:Type,类
说明:
导入模块
import Stack from '@ohos.util.Stack';
Stack
属性
系统能力:SystemCapability.Utils.Lang
名称 |
类型 |
可读 |
可写 |
说明 |
---|---|---|---|---|
length |
number |
是 |
否 |
Stack的元素个数。 |
鸿蒙开发指导文档:[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
参数:
参数名 |
类型 |
必填 |
说明 |
---|---|---|---|
item |
T |
是 |
添加进去的元素。 |
返回值:
错误码:
以下错误码的详细介绍请参见[语言基础类库错误码]。
示例:
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
参数:
参数名 |
类型 |
必填 |
说明 |
---|---|---|---|
element |
T |
是 |
指定元素。 |
返回值:
错误码:
以下错误码的详细介绍请参见[语言基础类库错误码]。
示例:
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 |
function |
是 |
回调函数。 |
thisArg |
Object |
否 |
callbackfn被调用时用作this值。 |
callbackfn的参数说明:
参数名 |
类型 |
必填 |
说明 |
---|---|---|---|
value |
T |
是 |
当前遍历到的元素。 |
index |
number |
否 |
当前遍历到的下标值。 |
stack |
Stack |
否 |
当前调用forEach方法的实例对象。 |
错误码:
以下错误码的详细介绍请参见[语言基础类库错误码]。
示例:
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;
}
审核编辑 黄宇
- 接口
- 鸿蒙
- OpenHarmony
评论
发布评论请先 登录
相关推荐