LongPriorityQueue (Primitive-Collections 0.8.0 API)

All Superinterfaces:

java.lang.Iterable<java.lang.Long>, LongIterable

All Known Subinterfaces:

LongPriorityDequeue

All Known Implementing Classes:

AbstractLongPriorityQueue, LongArrayFIFOQueue, LongArrayPriorityQueue, LongHeapPriorityQueue, LongLinkedList, LongPriorityQueues.SynchronizedPriorityDequeue, LongPriorityQueues.SynchronizedPriorityQueue
```
public interface LongPriorityQueue
extends LongIterable
```
A Simple PriorityQueue (or Queue) interface that provides with the nessesary functions to interact with it, without cluttering with the Collection interface.

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method and Description
`void`	`clear()` clears all elements within the PriorityQueue, this does not resize the backing arrays
`LongComparator`	`comparator()`
`LongPriorityQueue`	`copy()` A Function that does a shallow clone of the PriorityQueue itself.
`long`	`dequeue()` Method to extract a element from the PriorityQueue
`void`	`enqueue(long e)` Method to insert a element into the PriorityQueue
`default void`	`enqueueAll(long... e)` Method to mass insert elements into the PriorityQueue
`default void`	`enqueueAll(long[] e, int length)` Method to mass insert elements into the PriorityQueue
`default void`	`enqueueAll(long[] e, int offset, int length)` Method to mass insert elements into the PriorityQueue
`default void`	`enqueueAll(LongCollection c)` Method to mass insert elements into the PriorityQueue
`default long`	`first()` Shows the element that is to be returned next
`default boolean`	`isEmpty()`
`void`	`onChanged()` Allows to notify the Queue to be revalidate its data
`long`	`peek(int index)` Peeking function to see whats inside the queue.
`boolean`	`removeFirst(long e)` Removes the first found element in the queue
`boolean`	`removeLast(long e)` Removes the last found element in the queue
`int`	`size()`
`default LongPriorityQueue`	`synchronizeQueue()` Creates a Wrapped PriorityQueue that is Synchronized
`default LongPriorityQueue`	`synchronizeQueue(java.lang.Object mutex)` Creates a Wrapped PriorityQueue that is Synchronized
`default long[]`	`toLongArray()` A method to drop the contents of the Queue without clearing the queue
`long[]`	`toLongArray(long[] input)` A method to drop the contents of the Queue without clearing the queue

Methods inherited from interface speiger.src.collections.longs.collections.LongIterable
arrayflatMap, asAsync, count, distinct, filter, findFirst, flatMap, forEach, forEach, forEach, forEachIndexed, iterator, limit, map, matchesAll, matchesAny, matchesNone, peek, pour, pourAsList, pourAsSet, reduce, reduce, repeat, sorted, spliterator

- Method Detail
  - isEmpty
```
default boolean isEmpty()
```
    Returns:
    
    true if the PriorityQueue is empty
  - size
```
int size()
```
    Returns:
    
    the amount of elements that are stored in the PriorityQueue
  - clear
```
void clear()
```
    clears all elements within the PriorityQueue, this does not resize the backing arrays
  - enqueue
```
void enqueue(long e)
```
    Method to insert a element into the PriorityQueue
    
    Parameters:
    
    e - the element that should be inserted
  - enqueueAll
```
default void enqueueAll(long... e)
```
    Method to mass insert elements into the PriorityQueue
    
    Parameters:
    
    e - the elements that should be inserted
  - enqueueAll
```
default void enqueueAll(long[] e,
                        int length)
```
    Method to mass insert elements into the PriorityQueue
    
    Parameters:
    
    e - the elements that should be inserted
    
    length - the amount of elements that should be inserted
  - enqueueAll
```
default void enqueueAll(long[] e,
                        int offset,
                        int length)
```
    Method to mass insert elements into the PriorityQueue
    
    Parameters:
    
    e - the elements that should be inserted
    
    offset - the offset where in the array should be started
    
    length - the amount of elements that should be inserted
  - enqueueAll
```
default void enqueueAll(LongCollection c)
```
    Method to mass insert elements into the PriorityQueue
    
    Parameters:
    
    c - the elements that should be inserted from the Collection
  - dequeue
```
long dequeue()
```
    Method to extract a element from the PriorityQueue
    
    Returns:
    
    a element from the Queue
    
    Throws:
    
    java.util.NoSuchElementException - if no element is present
  - peek
```
long peek(int index)
```
    Peeking function to see whats inside the queue.
    
    Parameters:
    
    index - of the element that is requested to be viewed.
    
    Returns:
    
    the element that is requested
  - first
```
default long first()
```
    Shows the element that is to be returned next
    
    Returns:
    
    the first element in the Queue
  - removeFirst
```
boolean removeFirst(long e)
```
    Removes the first found element in the queue
    
    Parameters:
    
    e - the element that should be removed
    
    Returns:
    
    if a searched element was removed
  - removeLast
```
boolean removeLast(long e)
```
    Removes the last found element in the queue
    
    Parameters:
    
    e - the element that should be removed
    
    Returns:
    
    if a searched element was removed
  - onChanged
```
void onChanged()
```
    Allows to notify the Queue to be revalidate its data
  - copy
```
LongPriorityQueue copy()
```
    A Function that does a shallow clone of the PriorityQueue itself. This function is more optimized then a copy constructor since the PriorityQueue does not have to be unsorted/resorted. It can be compared to Cloneable but with less exception risk
    
    Returns:
    
    a Shallow Copy of the PriorityQueue
    
    Note:
    
    Wrappers and view PriorityQueues will not support this feature
  - comparator
```
LongComparator comparator()
```
    Returns:
    
    the sorter of the Queue, can be null
  - synchronizeQueue
```
default LongPriorityQueue synchronizeQueue()
```
    Creates a Wrapped PriorityQueue that is Synchronized
    
    Returns:
    
    a new PriorityQueue that is synchronized
    
    See Also:
    
    LongPriorityQueues.synchronize(speiger.src.collections.longs.queues.LongPriorityQueue)
  - synchronizeQueue
```
default LongPriorityQueue synchronizeQueue(java.lang.Object mutex)
```
    Creates a Wrapped PriorityQueue that is Synchronized
    
    Parameters:
    
    mutex - is the controller of the synchronization block
    
    Returns:
    
    a new PriorityQueue Wrapper that is synchronized
    
    See Also:
    
    LongPriorityQueues.synchronize(speiger.src.collections.longs.queues.LongPriorityQueue)
  - toLongArray
```
default long[] toLongArray()
```
    A method to drop the contents of the Queue without clearing the queue
    
    Specified by:
    
    toLongArray in interface LongIterable
    
    Returns:
    
    the contents of the queue into a seperate array.
  - toLongArray
```
long[] toLongArray(long[] input)
```
    A method to drop the contents of the Queue without clearing the queue
    
    Parameters:
    
    input - where the elements should be inserted to. If it does not fit then it creates a new appropiatly created array
    
    Returns:
    
    the contents of the queue into a seperate array.
    
    Note:
    
    if the Type is generic then a Object Array is created instead of a Type Array

Interface LongPriorityQueue

Method Summary

Methods inherited from interface speiger.src.collections.longs.collections.LongIterable

Method Detail

isEmpty

size

clear

enqueue

enqueueAll

enqueueAll

enqueueAll

enqueueAll

dequeue

peek

first

removeFirst

removeLast

onChanged

copy

comparator

synchronizeQueue

synchronizeQueue

toLongArray

toLongArray