1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
{{alias}}()
Stack constructor.
A stack is also referred to as a "last-in-first-out" queue.
Returns
-------
stack: Object
Stack data structure.
stack.clear: Function
Clears the stack.
stack.first: Function
Returns the "newest" stack value (i.e., the value which is "first-out").
If the stack is empty, the returned value is `undefined`.
stack.iterator: Function
Returns an iterator for iterating over a stack. If an environment
supports Symbol.iterator, the returned iterator is iterable. Note that,
in order to prevent confusion arising from stack mutation during
iteration, a returned iterator **always** iterates over a stack
"snapshot", which is defined as the list of stack elements at the time
of the method's invocation.
stack.last: Function
Returns the "oldest" stack value (i.e., the value which is "last-out").
If the stack is empty, the returned value is `undefined`.
stack.length: integer
Stack length.
stack.pop: Function
Removes and returns the current "first-out" value from the stack. If the
stack is empty, the returned value is `undefined`.
stack.push: Function
Adds a value to the stack.
stack.toArray: Function
Returns an array of stack values.
stack.toJSON: Function
Serializes a stack as JSON.
Examples
--------
> var s = {{alias}}();
> s.push( 'foo' ).push( 'bar' );
> s.length
2
> s.pop()
'bar'
> s.length
1
> s.pop()
'foo'
> s.length
0
See Also
--------
|
