Класс PriorityQueue<E>

public PriorityQueue()

public PriorityQueue(int initialCapacity)

Параметры:

initialCapacity — начальная емкость этой очереди с приоритетами

Исключения:

IllegalArgumentException — если initialCapacity меньше 1

public PriorityQueue(Comparator<? super E> comparator)

Параметры:

comparator — компаратор, который будет использоваться для упорядочивания этой очереди с приоритетами. Если null, будет использоваться естественный порядок элементов.

Начиная с версии:

1.8

public PriorityQueue(int initialCapacity, Comparator<? super E> comparator)

Параметры:

initialCapacity — начальная емкость этой очереди с приоритетами

comparator — компаратор, который будет использоваться для упорядочивания этой очереди с приоритетами. Если null, будет использоваться естественный порядок элементов.

Исключения:

IllegalArgumentException — если initialCapacity меньше 1

public PriorityQueue(Collection<? extends E> c)

Параметры:

c — коллекция, элементы которой нужно поместить в эту очередь с приоритетами

Исключения:

ClassCastException — если элементы указанной коллекции нельзя сравнить друг с другом в соответствии с порядком очереди с приоритетами

NullPointerException — если указанная коллекция или любой из ее элементов равен null

public PriorityQueue(PriorityQueue<? extends E> c)

Параметры:

c — очередь с приоритетами, элементы которой нужно поместить в эту очередь с приоритетами

Исключения:

ClassCastException — если элементы c нельзя сравнить друг с другом в соответствии с порядком c

NullPointerException — если указанная очередь с приоритетами или любой из ее элементов равен null

public PriorityQueue(SortedSet<? extends E> c)

Параметры:

c — отсортированное множество, элементы которого нужно поместить в эту очередь с приоритетами

Исключения:

ClassCastException — если элементы указанного отсортированного множества нельзя сравнить друг с другом в соответствии с порядком этого множества

NullPointerException — если указанное отсортированное множество или любой из его элементов равен null

public boolean add(E e)

Определен в:

add в интерфейсе Collection<E>

Определен в:

add в интерфейсе Queue<E>

Переопределяет:

add в классе AbstractQueue<E>

Параметры:

e — добавляемый элемент

Возвращает:

true (как указано в Collection.add(E))

Исключения:

ClassCastException — если указанный элемент нельзя сравнить с элементами, уже находящимися в этой очереди с приоритетами, в соответствии с порядком очереди

NullPointerException — если указанный элемент равен null

public boolean offer(E e)

Определен в:

offer в интерфейсе Queue<E>

Параметры:

e — добавляемый элемент

Возвращает:

true (как указано в Queue.offer(E))

Исключения:

ClassCastException — если указанный элемент нельзя сравнить с элементами, уже находящимися в этой очереди с приоритетами, в соответствии с порядком очереди

NullPointerException — если указанный элемент равен null

public E peek()

Определен в:

peek в интерфейсе Queue<E>

Возвращает:

голову этой очереди или null, если очередь пуста

public boolean remove(Object o)

Определен в:

remove в интерфейсе Collection<E>

Переопределяет:

remove в классе AbstractCollection<E>

Параметры:

o — элемент, который нужно удалить из этой очереди, если он присутствует

Возвращает:

true, если вызов изменил эту очередь

public boolean contains(Object o)

Определен в:

contains в интерфейсе Collection<E>

Переопределяет:

contains в классе AbstractCollection<E>

Параметры:

o — объект, наличие которого в этой очереди нужно проверить

Возвращает:

true, если эта очередь содержит указанный элемент

public Object[] toArray()

Определен в:

toArray в интерфейсе Collection<E>

Переопределяет:

toArray в классе AbstractCollection<E>

Возвращает:

массив, содержащий все элементы этой очереди

public <T> T[] toArray(T[] a)

 String[] y = x.toArray(new String[0]);

Определен в:

toArray в интерфейсе Collection<E>

Переопределяет:

toArray в классе AbstractCollection<E>

Параметры типа:

T — тип компонентов массива, в котором будет храниться коллекция

Параметры:

a — массив, в который нужно поместить элементы очереди, если он достаточно велик; в противном случае для этой цели выделяется новый массив того же типа во время выполнения.

Возвращает:

массив, содержащий все элементы этой очереди

Исключения:

ArrayStoreException — если тип указанного массива во время выполнения не является супертипом типа каждого элемента этой очереди во время выполнения

NullPointerException — если указанный массив равен null

public Iterator<E> iterator()

Определен в:

iterator в интерфейсе Collection<E>

Определен в:

iterator в интерфейсе Iterable<E>

Определен в:

iterator в классе AbstractCollection<E>

Возвращает:

итератор по элементам этой очереди

public int size()

Определен в:

size в интерфейсе Collection<E>

Возвращает:

количество элементов в этой коллекции

public void clear()

Определен в:

clear в интерфейсе Collection<E>

Переопределяет:

clear в классе AbstractQueue<E>

public E poll()

Определен в:

poll в интерфейсе Queue<E>

Возвращает:

голову этой очереди или null, если очередь пуста

public Comparator<? super E> comparator()

Возвращает:

компаратор, используемый для упорядочивания этой очереди, или null, если элементы этой очереди упорядочены согласно их естественному порядку

public final Spliterator<E> spliterator()

Определен в:

spliterator в интерфейсе Collection<E>

Определен в:

spliterator в интерфейсе Iterable<E>

Возвращает:

Spliterator для элементов этой очереди

Начиная с версии:

1.8

public boolean removeIf(Predicate<? super E> filter)

Определен в:

removeIf в интерфейсе Collection<E>

Параметры:

filter — предикат, возвращающий true для элементов, которые нужно удалить

Возвращает:

true, если были удалены какие-либо элементы

Исключения:

NullPointerException — если указанный фильтр равен null

public boolean removeAll(Collection<?> c)

Определен в:

removeAll в интерфейсе Collection<E>

Переопределяет:

removeAll в классе AbstractCollection<E>

Параметры:

c — коллекция, содержащая элементы, которые нужно удалить из этой коллекции

Возвращает:

true, если вызов изменил эту коллекцию

Исключения:

NullPointerException — если эта коллекция содержит один или несколько элементов null, а указанная коллекция не поддерживает элементы null (необязательно), либо если указанная коллекция равна null

См. также:

• AbstractCollection.remove(Object)
• AbstractCollection.contains(Object)

public boolean retainAll(Collection<?> c)

Определен в:

retainAll в интерфейсе Collection<E>

Переопределяет:

retainAll в классе AbstractCollection<E>

Параметры:

c — коллекция, содержащая элементы, которые нужно оставить в этой коллекции

Возвращает:

true, если вызов изменил эту коллекцию

Исключения:

NullPointerException — если эта коллекция содержит один или несколько элементов null, а указанная коллекция не допускает элементы null (необязательно), либо если указанная коллекция равна null

См. также:

• AbstractCollection.remove(Object)
• AbstractCollection.contains(Object)

public void forEach(Consumer<? super E> action)

Определен в:

forEach в интерфейсе Iterable<E>

Параметры:

action — действие, выполняемое для каждого элемента

Исключения:

NullPointerException — если указанное действие равно null