org.apache.commons.collections

Interface PriorityQueue

All Known Implementing Classes:

BinaryHeap, SynchronizedPriorityQueue

public interface PriorityQueue

Interface for priority queues. This interface does not dictate whether it is min or max heap.

Since:

1.0

Author:

Peter Donald

Method Summary

Methods

Modifier and Type	Method and Description
void	clear() Clear all elements from queue.
void	insert(java.lang.Object element) Insert an element into queue.
boolean	isEmpty() Test if queue is empty.
java.lang.Object	peek() Return element on top of heap but don't remove it.
java.lang.Object	pop() Return element on top of heap and remove it.

Method Detail

clear

void clear()

Clear all elements from queue.

insert

void insert(java.lang.Object element)

Insert an element into queue.

Parameters:

element - the element to be inserted

Throws:

java.lang.ClassCastException - if the specified element's type prevents it from being compared to other items in the queue to determine its relative priority.

isEmpty

boolean isEmpty()

Test if queue is empty.

Returns:

true if queue is empty else false.

peek

java.lang.Object peek()
                      throws java.util.NoSuchElementException

Return element on top of heap but don't remove it.

Returns:

the element at top of heap

Throws:

java.util.NoSuchElementException - if isEmpty() == true

pop

java.lang.Object pop()
                     throws java.util.NoSuchElementException

Return element on top of heap and remove it.

Returns:

the element at top of heap

Throws:

java.util.NoSuchElementException - if isEmpty() == true