ByteArrayFIFOQueue (Primitive-Collections 0.2.0 API)

java.lang.Object
- speiger.src.collections.bytes.queues.ByteArrayFIFOQueue

All Implemented Interfaces:

java.lang.Iterable<java.lang.Byte>, ByteIterable, BytePriorityDequeue, BytePriorityQueue, ObjectPriorityQueue<java.lang.Byte>, ITrimmable
```
public class ByteArrayFIFOQueue
extends java.lang.Object
implements BytePriorityDequeue, ITrimmable
```
A Simple First In First Out Priority Queue that is a Good Replacement for a linked list (or ArrayDequeue) Its specific implementation uses a backing array that grows and shrinks as it is needed.

Field Summary

Fields
Modifier and Type Field and Description

static int MIN_CAPACITY
The Minimum Capacity that is allowed

Fields
Modifier and Type	Field and Description
`static int`	`MIN_CAPACITY` The Minimum Capacity that is allowed

Constructor Summary

Constructors
Constructor and Description
`ByteArrayFIFOQueue()` Default Construtor
`ByteArrayFIFOQueue(byte[] values)` Constructor using a initial array
`ByteArrayFIFOQueue(byte[] values, int size)` Constructor using a initial array
`ByteArrayFIFOQueue(byte[] values, int offset, int size)` Constructor using a initial array
`ByteArrayFIFOQueue(int capacity)` Constructor with a Min Capacity

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`clear()` clears all elements within the PriorityQueue, this does not resize the backing arrays
`void`	`clearAndTrim(int size)` Trims the collection down to the requested size and clears all elements while doing so
`ByteComparator`	`comparator()`
`byte`	`dequeueByte()` Method to extract a element from the PriorityQueue
`byte`	`dequeueLastByte()` A Method to remove a element from the last place instead of the first
`void`	`enqueueByte(byte e)` Method to insert a element into the PriorityQueue
`void`	`enqueueFirstByte(byte e)` Method to insert a element into the first Index instead of the last.
`ByteIterator`	`iterator()` Returns an iterator over elements of type `T`.
`void`	`onChanged()` Allows to notify the Queue to be revalidate its data
`byte`	`peekByte(int index)` Peeking function to see whats inside the queue.
`boolean`	`removeByte(byte e)` Removes the first found element in the queue
`boolean`	`removeLastByte(byte e)` Removes the last found element in the queue
`int`	`size()`
`java.lang.Byte[]`	`toArray(java.lang.Byte[] input)` A method to drop the contents of the Queue without clearing the queue
`byte[]`	`toByteArray(byte[] input)` A method to drop the contents of the Queue without clearing the queue
`boolean`	`trim(int size)` Trims the original collection down to the size of the current elements or the requested size depending which is bigger

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface speiger.src.collections.bytes.queues.BytePriorityDequeue
dequeueLast, enqueueFirst, last, lastByte

Methods inherited from interface speiger.src.collections.bytes.queues.BytePriorityQueue
dequeue, enqueue, first, firstByte, peek, remove, removeLast, toArray, toByteArray

Methods inherited from interface speiger.src.collections.objects.queues.ObjectPriorityQueue
isEmpty

Methods inherited from interface speiger.src.collections.bytes.collections.ByteIterable
forEach, forEach, spliterator

Methods inherited from interface speiger.src.collections.utils.ITrimmable
clearAndTrim, trim

- Field Detail
  - MIN_CAPACITY
```
public static final int MIN_CAPACITY
```
    The Minimum Capacity that is allowed
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - ByteArrayFIFOQueue
```
public ByteArrayFIFOQueue(byte[] values)
```
    Constructor using a initial array
    
    Parameters:
    
    values - the Array that should be used
  - ByteArrayFIFOQueue
```
public ByteArrayFIFOQueue(byte[] values,
                          int size)
```
    Constructor using a initial array
    
    Parameters:
    
    values - the Array that should be used
    
    size - the amount of elements that are in the initial array
    
    Throws:
    
    java.lang.IllegalStateException - if values is smaller then size
  - ByteArrayFIFOQueue
```
public ByteArrayFIFOQueue(byte[] values,
                          int offset,
                          int size)
```
    Constructor using a initial array
    
    Parameters:
    
    values - the Array that should be used
    
    offset - where to begin in the initial array
    
    size - the amount of elements that are in the initial array
    
    Throws:
    
    java.lang.IllegalStateException - if values is smaller then size
  - ByteArrayFIFOQueue
```
public ByteArrayFIFOQueue(int capacity)
```
    Constructor with a Min Capacity
    
    Parameters:
    
    capacity - the initial capacity of the backing array
    
    Throws:
    
    java.lang.IllegalStateException - if the initial size is smaller 0
  - ByteArrayFIFOQueue
```
public ByteArrayFIFOQueue()
```
    Default Construtor
- Method Detail
  - iterator
```
public ByteIterator iterator()
```
    Description copied from interface: ByteIterable
    
    Returns an iterator over elements of type T.
    
    Specified by:
    
    iterator in interface java.lang.Iterable<java.lang.Byte>
    
    Specified by:
    
    iterator in interface ByteIterable
    
    Returns:
    
    an Iterator.
  - size
```
public int size()
```
    Specified by:
    
    size in interface ObjectPriorityQueue<java.lang.Byte>
    
    Returns:
    
    the amount of elements that are stored in the PriorityQueue
  - clear
```
public void clear()
```
    Description copied from interface: ObjectPriorityQueue
    
    clears all elements within the PriorityQueue, this does not resize the backing arrays
    
    Specified by:
    
    clear in interface ObjectPriorityQueue<java.lang.Byte>
  - enqueueByte
```
public void enqueueByte(byte e)
```
    Description copied from interface: BytePriorityQueue
    
    Method to insert a element into the PriorityQueue
    
    Specified by:
    
    enqueueByte in interface BytePriorityQueue
    
    Parameters:
    
    e - the element that should be inserted
  - enqueueFirstByte
```
public void enqueueFirstByte(byte e)
```
    Description copied from interface: BytePriorityDequeue
    
    Method to insert a element into the first Index instead of the last.
    
    Specified by:
    
    enqueueFirstByte in interface BytePriorityDequeue
    
    Parameters:
    
    e - the element that should be inserted into the first place
  - dequeueByte
```
public byte dequeueByte()
```
    Description copied from interface: BytePriorityQueue
    
    Method to extract a element from the PriorityQueue
    
    Specified by:
    
    dequeueByte in interface BytePriorityQueue
    
    Returns:
    
    a element from the Queue
  - dequeueLastByte
```
public byte dequeueLastByte()
```
    Description copied from interface: BytePriorityDequeue
    
    A Method to remove a element from the last place instead of the first
    
    Specified by:
    
    dequeueLastByte in interface BytePriorityDequeue
    
    Returns:
    
    the last element inserted
  - peekByte
```
public byte peekByte(int index)
```
    Description copied from interface: BytePriorityQueue
    
    Peeking function to see whats inside the queue.
    
    Specified by:
    
    peekByte in interface BytePriorityQueue
    
    Parameters:
    
    index - of the element that is requested to be viewed.
    
    Returns:
    
    the element that is requested
  - removeByte
```
public boolean removeByte(byte e)
```
    Description copied from interface: BytePriorityQueue
    
    Removes the first found element in the queue
    
    Specified by:
    
    removeByte in interface BytePriorityQueue
    
    Parameters:
    
    e - the element that should be removed
    
    Returns:
    
    if a searched element was removed
  - removeLastByte
```
public boolean removeLastByte(byte e)
```
    Description copied from interface: BytePriorityQueue
    
    Removes the last found element in the queue
    
    Specified by:
    
    removeLastByte in interface BytePriorityQueue
    
    Parameters:
    
    e - the element that should be removed
    
    Returns:
    
    if a searched element was removed
  - onChanged
```
public void onChanged()
```
    Description copied from interface: BytePriorityQueue
    
    Allows to notify the Queue to be revalidate its data
    
    Specified by:
    
    onChanged in interface BytePriorityQueue
    
    Specified by:
    
    onChanged in interface ObjectPriorityQueue<java.lang.Byte>
  - comparator
```
public ByteComparator comparator()
```
    Specified by:
    
    comparator in interface BytePriorityQueue
    
    Specified by:
    
    comparator in interface ObjectPriorityQueue<java.lang.Byte>
    
    Returns:
    
    the sorter of the Queue, can be null
  - trim
```
public boolean trim(int size)
```
    Description copied from interface: ITrimmable
    
    Trims the original collection down to the size of the current elements or the requested size depending which is bigger
    
    Specified by:
    
    trim in interface ITrimmable
    
    Parameters:
    
    size - the requested trim size.
    
    Returns:
    
    if the internal array has been trimmed.
  - clearAndTrim
```
public void clearAndTrim(int size)
```
    Trims the collection down to the requested size and clears all elements while doing so
    
    Specified by:
    
    clearAndTrim in interface ITrimmable
    
    Parameters:
    
    size - the amount of elements that should be allowed
    
    Note:
    
    this will enforce minimum size of the collection itself
  - toByteArray
```
public byte[] toByteArray(byte[] input)
```
    Description copied from interface: BytePriorityQueue
    
    A method to drop the contents of the Queue without clearing the queue
    
    Specified by:
    
    toByteArray in interface BytePriorityQueue
    
    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.
  - toArray
```
public java.lang.Byte[] toArray(java.lang.Byte[] input)
```
    Description copied from interface: ObjectPriorityQueue
    
    A method to drop the contents of the Queue without clearing the queue
    
    Specified by:
    
    toArray in interface BytePriorityQueue
    
    Specified by:
    
    toArray in interface ObjectPriorityQueue<java.lang.Byte>
    
    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.

Class ByteArrayFIFOQueue

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface speiger.src.collections.bytes.queues.BytePriorityDequeue

Methods inherited from interface speiger.src.collections.bytes.queues.BytePriorityQueue

Methods inherited from interface speiger.src.collections.objects.queues.ObjectPriorityQueue

Methods inherited from interface speiger.src.collections.bytes.collections.ByteIterable

Methods inherited from interface speiger.src.collections.utils.ITrimmable

Field Detail

MIN_CAPACITY

Constructor Detail

ByteArrayFIFOQueue

ByteArrayFIFOQueue

ByteArrayFIFOQueue

ByteArrayFIFOQueue

ByteArrayFIFOQueue

Method Detail

iterator

size

clear

enqueueByte

enqueueFirstByte

dequeueByte

dequeueLastByte

peekByte

removeByte

removeLastByte

onChanged

comparator

trim

clearAndTrim

toByteArray

toArray