Класс Stack<E>

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.Vector<E>

java.util.Stack<E>

Параметры типа:: E - Тип компонентных элементов

Все реализованные интерфейсы:: Serializable, Cloneable, Iterable<E>, Collection<E>, List<E>, RandomAccess, SequencedCollection<E>

public class Stack<E> extends Vector<E>

Класс Stack представляет собой стек объектов со свойством «последним вошел — первым вышел» (LIFO). Он расширяет класс Vector с пятью операциями, позволяющими использовать вектор как стек. Предоставляются обычные операции push и pop, а также метод для peek верхнего элемента стека, метод для проверки, является ли стек empty, и метод для search стека для элемента и определения его расстояния от вершины.

При первом создании стек не содержит элементов.

Более полное и согласованное наборы операций стека LIFO обеспечивает интерфейс Deque и его реализации, которые следует использовать вместо этого класса. Например:

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

С тех пор:

1.0

См. также:

Краткое описание полей

Объявленные в классе java.util.Vector поля

capacityIncrement, elementCount, elementData

Объявленные в классе java.util.AbstractList поля

modCount

Краткое описание конструкторов

Конструктор	Описание
`Stack()`	Создает пустой стек.

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`empty()`	Проверяет, пуст ли этот стек.
`E`	`peek()`	Просматривает объект вверху этого стека, не удаляя его из стека.
`E`	`pop()`	Удаляет объект вверху этого стека и возвращает этот объект как значение этого метода.
`E`	`push(E item)`	Добавляет элемент в верхнюю часть этого стека.
`int`	`search(Object o)`	Возвращает 1-основанную позицию, где находится объект в этом стеке.

Методы, объявленные в классе java.util.Vector

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, spliterator, subList, toArray, toArray, toString, trimToSize

Методы, объявленные в классе java.lang.Object

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

Методы, объявленные в интерфейсе java.util.Collection

parallelStream, stream, toArray

Методы, объявленные в интерфейсе java.util.List

addFirst, addLast, getFirst, getLast, removeFirst, removeLast, reversed, sort

Подробное описание конструкторов

Stack

public Stack()

Создает пустой стек.

Подробное описание методов

push

public E push(E item)

Добавляет элемент в верхнюю часть этого стека. Это имеет точно такой же эффект, как:

 addElement(item)

Параметры:

item - элемент, который нужно добавить в этот стек.

Возвращает:

переданный item аргумент.

См. также:

pop

public E pop()

Удаляет объект вверху этого стека и возвращает этот объект в качестве значения этого метода.

Возвращает:: Объект вверху этого стека (последний элемент объекта Vector).
Исключение:: EmptyStackException - если этот стек пуст.

peek

public E peek()

Просматривает объект вверху этого стека, не удаляя его из стека.

Возвращает:: объект вверху этого стека (последний элемент объекта Vector).
Исключение:: EmptyStackException - если этот стек пуст.

empty

public boolean empty()

Проверяет, пуст ли этот стек.

Возвращает:: true, если и только если этот стек не содержит элементов; false в противном случае.

search

public int search(Object o)

Возвращает 1-основанную позицию, где находится объект в этом стеке. Если объект o встречается в качестве элемента в этом стеке, этот метод возвращает расстояние от вершины стека до ближайшего вхождения, расположенного ближе к вершине стека; самый верхний элемент стека считается находящимся на расстоянии 1. Метод equals используется для сравнения o с элементами в этом стеке.

Параметры:: o - желаемый объект.
Возвращает:: 1-основанная позиция от вершины стека, где находится объект; значение возврата -1 указывает, что объект не находится в стеке.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/Stack.html