java.util
類別 Stack<E>

java.lang.Object
  java.util.AbstractCollection<E>
      java.util.AbstractList<E>
          java.util.Vector<E>
              java.util.Stack<E>

所有已實作的介面：

Serializable, Cloneable, Iterable<E>, Collection<E>, List<E>, RandomAccess

public class Stack<E>
extends Vector<E>

Stack 類別表示後進先出（LIFO）的物件堆疊(stack)空間。它通過五個操作對類別 Vector 進行了擴展 ，允許將向量視為堆疊(stack)空間。它提供了通常的 push 和 pop 操作，以及取堆疊(stack)空間頂點的 peek 方法、測試堆疊(stack)空間是否為空的 empty 方法、在堆疊(stack)空間中尋找項並確定到堆疊(stack)空間頂距離的 search 方法。

首次創建堆疊(stack)空間時，它不包含項。

Deque 介面及其實作提供了 LIFO 堆疊(stack)空間操作的更完整和更一致的 set，應該優先使用此 set，而非此類別。例如：

   Deque<Integer> stack = new ArrayDeque<Integer>();

從以下版本開始：

JDK1.0

另請參見：

序列化表格

欄位摘要

從類別 java.util.Vector 繼承的欄位

capacityIncrement, elementCount, elementData

從類別 java.util.AbstractList 繼承的欄位

modCount

建構子摘要

Stack()
創建一個空堆疊(stack)空間。

方法摘要

boolean	empty() 測試堆疊(stack)空間是否為空。
E	peek() 查看堆疊(stack)空間頂部的物件，但不從堆疊(stack)空間中移除它。
E	pop() 移除堆疊(stack)空間頂部的物件，並作為此函數的值返回該物件。
E	push(E item) 把項壓入堆疊(stack)空間頂部。
int	search(Object o) 返回物件在堆疊(stack)空間中的位置，以 1 為進制。

從類別 java.util.Vector 繼承的方法

add, add, addAll, addAll, addElement, capacity, clear, clone, contains, containsAll, copyInto, elementAt, elements, ensureCapacity, equals, firstElement, get, hashCode, indexOf, indexOf, insertElementAt, isEmpty, lastElement, lastIndexOf, lastIndexOf, remove, remove, removeAll, removeAllElements, removeElement, removeElementAt, removeRange, retainAll, set, setElementAt, setSize, size, subList, toArray, toArray, toString, trimToSize

從類別 java.util.AbstractList 繼承的方法

iterator, listIterator, listIterator

從類別 java.lang.Object 繼承的方法

finalize, getClass, notify, notifyAll, wait, wait, wait

從介面 java.util.List 繼承的方法

iterator, listIterator, listIterator

建構子詳細資訊

Stack

public Stack()

創建一個空堆疊(stack)空間。

方法詳細資訊

push

public E push(E item)

把項壓入堆疊(stack)空間頂部。其作用與下面的方法完全相同：

 addElement(item)

參數：

item - 壓入堆疊(stack)空間的項。

返回：

item 參數。

另請參見：

Vector.addElement(E)

pop

public E pop()

移除堆疊(stack)空間頂部的物件，並作為此函數的值返回該物件。

返回：

堆疊(stack)空間頂部的物件（Vector 物件中的最後一項）。

拋出：

EmptyStackException - 如果堆疊(stack)空間為空。

peek

public E peek()

查看堆疊(stack)空間頂部的物件，但不從堆疊(stack)空間中移除它。

返回：

堆疊(stack)空間頂部的物件（Vector 物件的最後一項）。

拋出：

EmptyStackException - 如果堆疊(stack)空間為空。

empty

public boolean empty()

測試堆疊(stack)空間是否為空。

返回：

當且僅當堆疊(stack)空間中不含任何項時返回 true；否則返回 false。

search

public int search(Object o)

返回物件在堆疊(stack)空間中的位置，以 1 為進制。如果物件 o 是堆疊(stack)空間中的一個項，此方法返回距堆疊(stack)空間頂部最近的出現位置到堆疊(stack)空間頂部的距離；堆疊(stack)空間中最頂部項的距離為 1。使用 equals 方法比較 o 與堆疊(stack)空間中的項。

參數：

o - 目標物件。

返回：

物件到堆疊(stack)空間頂部的位置，以 1 為進制；返回值 -1 表示此物件不在堆疊(stack)空間中。