public class Stack<E> extends Vector<E>
Stack
class represents a last-in-first-out
(LIFO) stack of objects. It extends class Vector with five
operations that allow a vector to be treated as a stack. The usual
push and pop operations are provided, as well as a
method to peek at the top item on the stack, a method to test
for whether the stack is empty, and a method to search
the stack for an item and discover how far it is from the top.
When a stack is first created, it contains no items.
A more complete and consistent set of LIFO stack operations is
provided by the Deque
interface and its implementations, which
should be used in preference to this class. For example:
Deque<Integer> stack = new ArrayDeque<Integer>();
capacityIncrement, elementCount, elementData
modCount
Constructor and Description |
---|
Stack()
Creates an empty Stack.
|
Modifier and Type | Method and Description |
---|---|
boolean |
empty()
Tests if this stack is empty.
|
E |
peek()
Looks at the object at the top of this stack without removing it
from the stack.
|
E |
pop()
Removes the object at the top of this stack and returns that
object as the value of this function.
|
E |
push(E item)
Pushes an item onto the top of this stack.
|
int |
search(Object o)
Returns the 1-based position where an object is on this stack.
|
add, add, addAll, addAll, addElement, capacity, clear, clone, contains, containsAll, copyInto, elementAt, elements, ensureCapacity, equals, firstElement, forEach, get, hashCode, indexOf, indexOf, insertElementAt, isEmpty, iterator, lastElement, lastIndexOf, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeAllElements, removeElement, removeElementAt, removeIf, removeRange, replaceAll, retainAll, set, setElementAt, setSize, size, sort, spliterator, subList, toArray, toArray, toString, trimToSize
finalize, getClass, notify, notifyAll, wait, wait, wait
parallelStream, stream
public E push(E item)
addElement(item)
item
- the item to be pushed onto this stack.item
argument.Vector.addElement(E)
public E pop()
EmptyStackException
- if this stack is empty.public E peek()
EmptyStackException
- if this stack is empty.public boolean empty()
true
if and only if this stack contains
no items; false
otherwise.public int search(Object o)
o
- the desired object.-1
indicates that the object is not on the stack. Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2016, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.