Spec-Zone.ru › OpenJDK 17

Класс ArrayDeque<E>

java.lang.Object
java.util.AbstractCollection<E>
java.util.ArrayDeque<E>
Type Parameters:
E - тип элементов, хранящихся в этом очереди с двойным концом
Все реализованные интерфейсы:
Serializable, Cloneable, Iterable<E>, Collection<E>, Deque<E>, Queue<E>
public class ArrayDeque<E> extends AbstractCollection<E> implements Deque<E>, Cloneable, Serializable
Реализация очереди с двойным концом Deque на основе массива с возможностью изменения размера. Очереди с двойным концом на основе массива не имеют ограничений по размеру; они увеличиваются по мере необходимости для поддержки использования. Они не потокобезопасны; при отсутствии внешней синхронизации они не поддерживают одновременный доступ нескольких потоков. Нулевые элементы запрещены. Этот класс, вероятно, будет быстрее, чем Stack при использовании в качестве стека, и быстрее, чем LinkedList при использовании в качестве очереди.

Большинство ArrayDeque операций выполняются за амортизированное постоянное время. К исключениям относятся remove, removeFirstOccurrence, removeLastOccurrence, contains, iterator.remove() и операции по работе со множеством элементов, все из которых выполняются за линейное время.

Итераторы, возвращаемые методом iterator этого класса, являются быстродействующими: если очередь с двойным концом изменяется в любой момент после создания итератора, любым способом, кроме использования метода самого итератора remove, итератор обычно выбросит исключение ConcurrentModificationException. Таким образом, при одновременном изменении итератор быстро и корректно завершает работу, а не рискует произвольным неопределенным поведением в неопределенное время в будущем.

Обратите внимание, что гарантировать быстродействие итераторов невозможно, так как, как правило, невозможно дать гарантии в случае одновременных изменений без синхронизации. Быстродействующие итераторы выбрасывают ConcurrentModificationException по возможности. Поэтому неправильно писать программу, которая полагалась бы на это исключение для обеспечения корректности: быстродействие итераторов следует использовать только для обнаружения ошибок.

Этот класс и его итератор реализуют все необязательные методы интерфейсов Collection и Iterator.

Этот класс является членом Java Collections Framework.

Since:
1.6
См. также:
  • Сериализованная форма

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

Конструктор Описание
ArrayDeque()
Создаёт пустой массивский дек с начальной ёмкостью, достаточной для хранения 16 элементов.
ArrayDeque(int numElements)
Создаёт пустой массивский дек с начальной ёмкостью, достаточной для хранения указанного количества элементов.
ArrayDeque(Collection<? extends E> c)
Создаёт дек, содержащий элементы указанного набора в порядке, в котором они возвращаются итератором набора.

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

Модификатор и тип Метод Описание
boolean add(E e)
Вставляет указанный элемент в конец этого дека.
boolean addAll(Collection<? extends E> c)
Добавляет все элементы в указанном наборе в конец этого дека, как если бы вызывали addLast(E) для каждого элемента в порядке, в котором они возвращаются итератором набора.
void addFirst(E e)
Вставляет указанный элемент в начало этого дека.
void addLast(E e)
Вставляет указанный элемент в конец этого дека.
void clear()
Удаляет все элементы из этого дека.
ArrayDeque<E> clone()
Возвращает копию этого дека.
boolean contains(Object o)
Возвращает true, если этот дек содержит указанный элемент.
Iterator<E> descendingIterator()
Возвращает итератор над элементами в этом деке в обратном порядке следования.
E element()
Возвращает голову очереди, представленной этим деком, но не удаляет её.
void forEach(Consumer<? super E> action)
Выполняет заданное действие для каждого элемента Iterable до тех пор, пока все элементы не будут обработаны или действие не выбросит исключение.
E getFirst()
Возвращает первый элемент этого дека, но не удаляет его.
E getLast()
Возвращает последний элемент этого дека, но не удаляет его.
boolean isEmpty()
Возвращает true, если этот дек не содержит элементов.
Iterator<E> iterator()
Возвращает итератор над элементами в этом деке.
boolean offer(E e)
Вставляет указанный элемент в конец этого дека.
boolean offerFirst(E e)
Вставляет указанный элемент в начало этого дека.
boolean offerLast(E e)
Вставляет указанный элемент в конец этого дека.
E peek()
Возвращает голову очереди, представленной этим деком, но не удаляет её или возвращает null, если этот дек пуст.
E peekFirst()
Возвращает первый элемент этого дека, но не удаляет его или возвращает null, если этот дек пуст.
E peekLast()
Возвращает последний элемент этого дека, но не удаляет его или возвращает null, если этот дек пуст.
E poll()
Возвращает и удаляет голову очереди, представленной этим деком (то есть первый элемент этого дека), или возвращает null, если этот дек пуст.
E pollFirst()
Возвращает и удаляет первый элемент этого дека, или возвращает null, если этот дек пуст.
E pollLast()
Возвращает и удаляет последний элемент этого дека, или возвращает null, если этот дек пуст.
E pop()
Извлекает элемент из стека, представленного этим деком.
void push(E e)
Вставляет элемент в стек, представленный этим деком.
E remove()
Возвращает и удаляет голову очереди, представленной этим деком.
boolean remove(Object o)
Удаляет один экземпляр указанного элемента из этого дека.
boolean removeAll(Collection<?> c)
Удаляет все элементы этого набора, которые также содержатся в указанном наборе (необязательная операция).
E removeFirst()
Возвращает и удаляет первый элемент этого дека.
boolean removeFirstOccurrence(Object o)
Удаляет первое вхождение указанного элемента в этом деке (при прохождении дека от начала к концу).
boolean removeIf(Predicate<? super E> filter)
Удаляет все элементы этого набора, которые удовлетворяют заданному предикату.
E removeLast()
Возвращает и удаляет последний элемент этого дека.
boolean removeLastOccurrence(Object o)
Удаляет последнее вхождение указанного элемента в этом деке (при прохождении дека от начала к концу).
boolean retainAll(Collection<?> c)
Оставляет только элементы в этом наборе, которые содержатся в указанном наборе (необязательная операция).
int size()
Возвращает количество элементов в этом деке.
Spliterator<E> spliterator()
Создаёт позднее связывание и быстрое Spliterator над элементами в этом деке.
Object[] toArray()
Возвращает массив, содержащий все элементы в этом деке в правильной последовательности (от первого к последнему элементу).
<T> T[] toArray(T[] a)
Возвращает массив, содержащий все элементы в этом деке в правильной последовательности (от первого к последнему элементу); тип возвращаемого массива соответствует указанному массиву.

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

containsAll, toString

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

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

containsAll, equals, hashCode, parallelStream, stream, toArray

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

ArrayDeque

public ArrayDeque()
Создает пустую очередь с массивом, имеющую начальную емкость, достаточную для хранения 16 элементов.

ArrayDeque

public ArrayDeque(int numElements)
Создает пустую очередь с массивом, имеющую начальную емкость, достаточную для хранения указанного количества элементов.
Параметры:
numElements - нижняя граница начальной емкости очереди

ArrayDeque

public ArrayDeque(Collection<? extends E> c)
Создает очередь, содержащую элементы указанной коллекции, в том порядке, в котором они возвращаются итератором коллекции. (Первый элемент, возвращаемый итератором коллекции, становится первым элементом или началом очереди.)
Параметры:
c - коллекция, элементы которой должны быть помещены в очередь
Исключения:
NullPointerException - если указанная коллекция равна null

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

addFirst

public void addFirst(E e)
Вставляет указанный элемент в начало этой очереди.
Указано в:
addFirst в интерфейсе Deque<E>
Параметры:
e - элемент для добавления
Исключения:
NullPointerException - если указанный элемент равен null

addLast

public void addLast(E e)
Вставляет указанный элемент в конец этой очереди.

Этот метод эквивалентен add(E).

Указано в:
addLast в интерфейсе Deque<E>
Параметры:
e - элемент для добавления
Исключения:
NullPointerException - если указанный элемент равен null

addAll

public boolean addAll(Collection<? extends E> c)
Добавляет все элементы в указанной коллекции в конец этой очереди, как если бы вы вызывали addLast(E) для каждого из них, в том порядке, в котором они возвращаются итератором коллекции.
Указано в:
addAll в интерфейсе Collection<E>
Указано в:
addAll в интерфейсе Deque<E>
Переопределяет:
addAll в классе AbstractCollection<E>
Параметры:
c - элементы, которые должны быть вставлены в эту очередь
Возвращает:
true если эта очередь изменилась в результате вызова
Исключения:
NullPointerException - если указанная коллекция или любой из ее элементов равны null
См. также:
  • AbstractCollection.add(Object)

offerFirst

public boolean offerFirst(E e)
Вставляет указанный элемент в начало этой очереди.
Указано в:
offerFirst в интерфейсе Deque<E>
Параметры:
e - элемент для добавления
Возвращает:
true (как указано в Deque.offerFirst(E))
Исключения:
NullPointerException - если указанный элемент равен null

offerLast

public boolean offerLast(E e)
Вставляет указанный элемент в конец этой очереди.
Указано в:
offerLast в интерфейсе Deque<E>
Параметры:
e - элемент для добавления
Возвращает:
true (как указано в Deque.offerLast(E))
Исключения:
NullPointerException - если указанный элемент равен null

removeFirst

public E removeFirst()
Описание скопировано из интерфейса: Deque
Извлекает и удаляет первый элемент этой очереди. Этот метод отличается от pollFirst только тем, что он вызывает исключение, если эта очередь пуста.
Указано в:
removeFirst в интерфейсе Deque<E>
Возвращает:
начало этой очереди
Исключения:
NoSuchElementException - если эта очередь пуста

removeLast

public E removeLast()
Описание скопировано из интерфейса: Deque
Извлекает и удаляет последний элемент этой очереди. Этот метод отличается от pollLast только тем, что он вызывает исключение, если эта очередь пуста.
Указано в:
removeLast в интерфейсе Deque<E>
Возвращает:
конец этой очереди
Исключения:
NoSuchElementException - если эта очередь пуста

pollFirst

public E pollFirst()
Описание скопировано из интерфейса: Deque
Извлекает и удаляет первый элемент этой очереди или возвращает null если эта очередь пуста.
Указано в:
pollFirst в интерфейсе Deque<E>
Возвращает:
начало этой очереди или null если эта очередь пуста

pollLast

public E pollLast()
Описание скопировано из интерфейса: Deque
Извлекает и удаляет последний элемент этой очереди или возвращает null если эта очередь пуста.
Указано в:
pollLast в интерфейсе Deque<E>
Возвращает:
конец этой очереди или null если эта очередь пуста

getFirst

public E getFirst()
Описание скопировано из интерфейса: Deque
Извлекает, но не удаляет, первый элемент этой очереди. Этот метод отличается от peekFirst только тем, что он вызывает исключение, если эта очередь пуста.
Указано в:
getFirst в интерфейсе Deque<E>
Возвращает:
начало этой очереди
Исключения:
NoSuchElementException - если эта очередь пуста

getLast

public E getLast()
Описание скопировано из интерфейса: Deque
Извлекает, но не удаляет, последний элемент этой очереди. Этот метод отличается от peekLast только тем, что он вызывает исключение, если эта очередь пуста.
Указано в:
getLast в интерфейсе Deque<E>
Возвращает:
конец этой очереди
Исключения:
NoSuchElementException - если эта очередь пуста

peekFirst

public E peekFirst()
Описание скопировано из интерфейса: Deque
Извлекает, но не удаляет, первый элемент этой очереди или возвращает null если эта очередь пуста.
Указано в:
peekFirst в интерфейсе Deque<E>
Возвращает:
начало этой очереди или null если эта очередь пуста

peekLast

public E peekLast()
Описание скопировано из интерфейса: Deque
Извлекает, но не удаляет, последний элемент этой очереди или возвращает null если эта очередь пуста.
Указано в:
peekLast в интерфейсе Deque<E>
Возвращает:
конец этой очереди или null если эта очередь пуста

removeFirstOccurrence

public boolean removeFirstOccurrence(Object o)
Удаляет первое вхождение указанного элемента в этой очереди (при обходе очереди от начала до конца). Если очередь не содержит элемент, она не изменяется. Более формально, удаляет первый элемент e такой, что o.equals(e) (если такой элемент существует). Возвращает true если эта очередь содержала указанный элемент (или, что эквивалентно, если эта очередь изменилась в результате вызова).
Указано в:
removeFirstOccurrence в интерфейсе Deque<E>
Параметры:
o - элемент, который должен быть удален из этой очереди, если он присутствует
Возвращает:
true если очередь содержала указанный элемент

удалитьПоследнееВхождение

public boolean removeLastOccurrence(Object o)
Удаляет последнее вхождение указанного элемента в эту очередь с двойной очередью (при обходе очереди с двойной очередью от начала к концу). Если в очереди с двойной очередью нет элемента, она не изменяется. Более формально, удаляет последний элемент e такой, что o.equals(e) (если такой элемент существует). Возвращает true , если эта очередь с двойной очередью содержала указанный элемент (или, что эквивалентно, если эта очередь с двойной очередью изменилась в результате вызова).
Specified by:
removeLastOccurrence в интерфейсе Deque<E>
Parameters:
o - элемент, который нужно удалить из этой очереди с двойной очередью, если он присутствует
Returns:
true , если очередь с двойной очередью содержала указанный элемент

добавить

public boolean add(E e)
Вставляет указанный элемент в конец этой очереди с двойной очередью.

Этот метод эквивалентен addLast(E).

Specified by:
add в интерфейсе Collection<E>
Specified by:
add в интерфейсе Deque<E>
Specified by:
add в интерфейсе Queue<E>
Overrides:
add в классе AbstractCollection<E>
Parameters:
e - добавляемый элемент
Returns:
true (как указано в Collection.add(E))
Throws:
NullPointerException - если указанный элемент равен null

предложить

public boolean offer(E e)
Вставляет указанный элемент в конец этой очереди с двойной очередью.

Этот метод эквивалентен offerLast(E).

Specified by:
offer в интерфейсе Deque<E>
Specified by:
offer в интерфейсе Queue<E>
Parameters:
e - добавляемый элемент
Returns:
true (как указано в Queue.offer(E))
Throws:
NullPointerException - если указанный элемент равен null

удалить

public E remove()
Извлекает и удаляет голову очереди, представленной этой очередью с двойной очередью. Этот метод отличается от poll() только тем, что выбрасывает исключение, если эта очередь с двойной очередью пуста.

Этот метод эквивалентен removeFirst().

Specified by:
remove в интерфейсе Deque<E>
Specified by:
remove в интерфейсе Queue<E>
Returns:
голова очереди, представленная этой очередью с двойной очередью
Throws:
NoSuchElementException - если эта очередь с двойной очередью пуста

получитьИУдалить

public E poll()
Извлекает и удаляет голову очереди, представленной этой очередью с двойной очередью (другими словами, первый элемент этой очереди с двойной очередью) или возвращает null , если эта очередь с двойной очередью пуста.

Этот метод эквивалентен pollFirst().

Specified by:
poll в интерфейсе Deque<E>
Specified by:
poll в интерфейсе Queue<E>
Returns:
голова очереди, представленная этой очередью с двойной очередью, или null , если эта очередь с двойной очередью пуста

элемент

public E element()
Извлекает, но не удаляет, голову очереди, представленной этой очередью с двойной очередью. Этот метод отличается от peek только тем, что выбрасывает исключение, если эта очередь с двойной очередью пуста.

Этот метод эквивалентен getFirst().

Specified by:
element в интерфейсе Deque<E>
Specified by:
element в интерфейсе Queue<E>
Returns:
голова очереди, представленная этой очередью с двойной очередью
Throws:
NoSuchElementException - если эта очередь с двойной очередью пуста

получить

public E peek()
Извлекает, но не удаляет, голову очереди, представленной этой очередью с двойной очередью, или возвращает null , если эта очередь с двойной очередью пуста.

Этот метод эквивалентен peekFirst().

Specified by:
peek в интерфейсе Deque<E>
Specified by:
peek в интерфейсе Queue<E>
Returns:
голова очереди, представленная этой очередью с двойной очередью, или null , если эта очередь с двойной очередью пуста

положить

public void push(E e)
Помещает элемент на стек, представленный этой очередью с двойной очередью. Другими словами, вставляет элемент в начало этой очереди с двойной очередью.

Этот метод эквивалентен addFirst(E).

Specified by:
push в интерфейсе Deque<E>
Parameters:
e - элемент для помещения
Throws:
NullPointerException - если указанный элемент равен null

вытащить

public E pop()
Извлекает элемент из стека, представленного этой очередью с двойной очередью. Другими словами, удаляет и возвращает первый элемент этой очереди с двойной очередью.

Этот метод эквивалентен removeFirst().

Specified by:
pop в интерфейсе Deque<E>
Returns:
элемент в начале этой очереди с двойной очередью (который является вершиной стека, представленного этой очередью с двойной очередью)
Throws:
NoSuchElementException - если эта очередь с двойной очередью пуста

размер

public int size()
Возвращает количество элементов в этой очереди с двойной очередью.
Specified by:
size в интерфейсе Collection<E>
Specified by:
size в интерфейсе Deque<E>
Returns:
количество элементов в этой очереди с двойной очередью

пустая

public boolean isEmpty()
Возвращает true , если эта очередь с двойной очередью не содержит элементов.
Specified by:
isEmpty в интерфейсе Collection<E>
Overrides:
isEmpty в классе AbstractCollection<E>
Returns:
true , если эта очередь с двойной очередью не содержит элементов

итератор

public Iterator<E> iterator()
Возвращает итератор по элементам в этой очереди с двойной очередью. Элементы будут упорядочены от первого (начала) до последнего (конца). Это тот же порядок, в котором элементы будут извлекаться из очереди (посредством последовательных вызовов remove()) или извлекаться из стека (посредством последовательных вызовов pop()).
Specified by:
iterator в интерфейсе Collection<E>
Specified by:
iterator в интерфейсе Deque<E>
Specified by:
iterator в интерфейсе Iterable<E>
Specified by:
iterator в классе AbstractCollection<E>
Returns:
итератор по элементам в этой очереди с двойной очередью

обратныйИтератор

public Iterator<E> descendingIterator()
Описание скопировано из интерфейса: Deque
Возвращает итератор по элементам в этой очереди с двойной очередью в обратном порядке. Элементы будут возвращены в порядке от последнего (конца) до первого (начала).
Specified by:
descendingIterator в интерфейсе Deque<E>
Returns:
итератор по элементам в этой очереди с двойной очередью в обратном порядке

разделитель

public Spliterator<E> spliterator()
Создает связанный позднее и быстро разрушающийся Spliterator по элементам в этой очереди с двойной очередью.

Spliterator сообщает Spliterator.SIZED, Spliterator.SUBSIZED, Spliterator.ORDERED и Spliterator.NONNULL. Реализующие классы должны документировать сообщения об дополнительных характеристиках.

Specified by:
spliterator в интерфейсе Collection<E>
Specified by:
spliterator в интерфейсе Iterable<E>
Returns:
Spliterator по элементам в этой очереди с двойной очередью
Since:
1.8

forEach

public void forEach(Consumer<? super E> action)
Описание скопировано из интерфейса: Iterable
Выполняет заданное действие для каждого элемента Iterable , пока все элементы не будут обработаны или действие не выбросит исключение. Действия выполняются в порядке итерации, если этот порядок указан. Исключения, сгенерированные действием, передаются вызывающей стороне.

Поведение этого метода не определено, если действие выполняет побочные эффекты, изменяющие исходный источник элементов, если только перекрывающий класс не указал политику одновременного изменения.

Specified by:
forEach в интерфейсе Iterable<E>
Parameters:
action - действие, выполняемое для каждого элемента
Throws:
NullPointerException - если заданное действие равно null

removeIf

public boolean removeIf(Predicate<? super E> filter)
Описание скопировано из интерфейса: Collection
Удаляет все элементы этого набора, удовлетворяющие заданному предикату. Ошибки или исключения времени выполнения, сгенерированные во время итерации или предикатом, передаются вызывающей стороне.
Указано в:
removeIf в интерфейсе Collection<E>
Параметры:
filter - предикат, возвращающий true для элементов, подлежащих удалению
Возвращает:
true если были удалены какие-либо элементы
Исключение:
NullPointerException - если указанный фильтр равен null

removeAll

public boolean removeAll(Collection<?> c)
Описание скопировано из класса: AbstractCollection
Удаляет все элементы этого набора, также содержащиеся в указанном наборе (необязательная операция). После возврата этого вызова этот набор не будет содержать общих элементов с указанным набором.
Указано в:
removeAll в интерфейсе Collection<E>
Переопределяет:
removeAll в классе AbstractCollection<E>
Параметры:
c - набор, содержащий элементы, подлежащие удалению из этого набора
Возвращает:
true если этот набор изменился в результате вызова
Исключение:
NullPointerException - если этот набор содержит один или несколько элементов null, а указанный набор не поддерживает элементы null (необязательное), или если указанный набор равен null
См. также:
  • AbstractCollection.remove(Object)
  • AbstractCollection.contains(Object)

retainAll

public boolean retainAll(Collection<?> c)
Описание скопировано из класса: AbstractCollection
Сохраняет только элементы в этом наборе, которые содержатся в указанном наборе (необязательная операция). Другими словами, удаляет из этого набора все его элементы, которые не содержатся в указанном наборе.
Указано в:
retainAll в интерфейсе Collection<E>
Переопределяет:
retainAll в классе AbstractCollection<E>
Параметры:
c - набор, содержащий элементы, которые должны сохраниться в этом наборе
Возвращает:
true если этот набор изменился в результате вызова
Исключение:
NullPointerException - если этот набор содержит один или несколько элементов null, а указанный набор не допускает элементов null (необязательное), или если указанный набор равен null
См. также:
  • AbstractCollection.remove(Object)
  • AbstractCollection.contains(Object)

contains

public boolean contains(Object o)
Возвращает true , если эта очередь содержит указанный элемент. Более формально, возвращает true , если и только если эта очередь содержит по крайней мере один элемент e , такой что o.equals(e).
Указано в:
contains в интерфейсе Collection<E>
Указано в:
contains в интерфейсе Deque<E>
Переопределяет:
contains в классе AbstractCollection<E>
Параметры:
o - объект, который проверяется на наличие в этой очереди
Возвращает:
true если эта очередь содержит указанный элемент

remove

public boolean remove(Object o)
Удаляет один экземпляр указанного элемента из этой очереди. Если в очереди нет этого элемента, она не изменяется. Более формально, удаляет первый элемент e , такой что o.equals(e) (если такой элемент существует). Возвращает true , если эта очередь содержала указанный элемент (или, эквивалентно, если эта очередь изменилась в результате вызова).

Этот метод эквивалентен removeFirstOccurrence(Object).

Указано в:
remove в интерфейсе Collection<E>
Указано в:
remove в интерфейсе Deque<E>
Переопределяет:
remove в классе AbstractCollection<E>
Параметры:
o - элемент, подлежащий удалению из этой очереди, если он присутствует
Возвращает:
true если эта очередь содержала указанный элемент

clear

public void clear()
Удаляет все элементы из этой очереди. Очередь будет пустой после возврата этого вызова.
Указано в:
clear в интерфейсе Collection<E>
Переопределяет:
clear в классе AbstractCollection<E>

toArray

public Object[] toArray()
Возвращает массив, содержащий все элементы в этой очереди в правильном порядке (от первого к последнему элементу).

Возвращаемый массив будет «безопасным», так как на него не ссылается эта очередь. (Другими словами, этот метод должен выделить новый массив). Таким образом, вызывающая сторона может свободно изменять возвращаемый массив.

Этот метод действует как мост между API на основе массивов и API на основе коллекций.

Указано в:
toArray в интерфейсе Collection<E>
Переопределяет:
toArray в классе AbstractCollection<E>
Возвращает:
массив, содержащий все элементы в этой очереди

toArray

public <T> T[] toArray(T[] a)
Возвращает массив, содержащий все элементы в этой очереди в правильном порядке (от первого к последнему элементу); тип выполнения возвращаемого массива — тип указанного массива. Если очередь помещается в указанный массив, она возвращается в нем. В противном случае выделяется новый массив с типом выполнения указанного массива и размером этой очереди.

Если эта очередь помещается в указанный массив с избытком места (т. е. массив имеет больше элементов, чем эта очередь), элемент в массиве сразу после конца очереди устанавливается в null.

Как и метод toArray(), этот метод действует как мост между API на основе массивов и API на основе коллекций. Кроме того, этот метод позволяет точно управлять типом выполнения выходного массива и в определенных ситуациях может использоваться для экономии затрат на выделение памяти.

Предположим, x — это очередь, известная тем, что содержит только строки. Следующий код может использоваться для выгрузки очереди в новый выделенный массив String:

 String[] y = x.toArray(new String[0]);
Обратите внимание, что toArray(new Object[0]) идентичен по функции toArray().
Указано в:
toArray в интерфейсе Collection<E>
Переопределяет:
toArray в классе AbstractCollection<E>
Параметры типа:
T - тип компонента массива, содержащего коллекцию
Параметры:
a - массив, в который будут помещены элементы очереди, если он достаточно большой; в противном случае для этой цели выделяется новый массив того же типа выполнения
Возвращает:
массив, содержащий все элементы в этой очереди
Исключение:
ArrayStoreException - если тип выполнения указанного массива не является супертипом типа выполнения каждого элемента в этой очереди
NullPointerException - если указанный массив равен null

clone

public ArrayDeque<E> clone()
Возвращает копию этой очереди.
Переопределяет:
clone в классе Object
Возвращает:
копию этой очереди
См. также:
  • Cloneable

© 1993, 2021, 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://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/ArrayDeque.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API