public class Array<T>
extends java.lang.Object
implements java.lang.Iterable<T>
| Modifier and Type | Class and Description |
|---|---|
static class |
Array.ArrayIterable<T> |
static class |
Array.ArrayIterator<T> |
| Modifier and Type | Field and Description |
|---|---|
T[] |
items
Provides direct access to the underlying array.
|
boolean |
ordered |
int |
size |
| Constructor and Description |
|---|
Array()
Creates an ordered array with a capacity of 16.
|
Array(Array array)
Creates a new array containing the elements in the specified array.
|
Array(boolean ordered,
int capacity) |
Array(boolean ordered,
int capacity,
java.lang.Class<T> arrayType)
Creates a new array with
items of the specified type. |
Array(boolean ordered,
T[] array)
Creates a new array containing the elements in the specified array.
|
Array(java.lang.Class<T> arrayType)
Creates an ordered array with
items of the specified type and a capacity of 16. |
Array(int capacity)
Creates an ordered array with the specified capacity.
|
Array(T[] array)
Creates a new ordered array containing the elements in the specified array.
|
| Modifier and Type | Method and Description |
|---|---|
void |
add(T value) |
void |
addAll(Array array) |
void |
addAll(Array array,
int offset,
int length) |
void |
addAll(T[] array) |
void |
addAll(T[] array,
int offset,
int length) |
void |
clear() |
boolean |
contains(T value,
boolean identity)
Returns if this array contains value.
|
T[] |
ensureCapacity(int additionalCapacity)
Increases the size of the backing array to acommodate the specified number of additional items.
|
boolean |
equals(java.lang.Object object) |
T |
first()
Returns the first item.
|
T |
get(int index) |
int |
indexOf(T value,
boolean identity)
Returns an index of first occurrence of value in array or -1 if no such value exists
|
void |
insert(int index,
T value) |
java.util.Iterator<T> |
iterator()
Returns an iterator for the items in the array.
|
int |
lastIndexOf(T value,
boolean identity)
Returns an index of last occurrence of value in array or -1 if no such value exists.
|
T |
peek()
Returns the last item.
|
T |
pop()
Removes and returns the last item.
|
T |
random()
Returns a random item from the array, or null if the array is empty.
|
boolean |
removeAll(Array<T> array,
boolean identity)
Removes from this array all of elements contained in the specified array.
|
T |
removeIndex(int index)
Removes and returns the item at the specified index.
|
boolean |
removeValue(T value,
boolean identity)
Removes value from an array if it exists.
|
protected T[] |
resize(int newSize)
Creates a new backing array with the specified size containing the current items.
|
void |
reverse() |
java.lang.Iterable<T> |
select(Predicate<T> predicate)
Returns an iterable for the selected items in the array.
|
void |
set(int index,
T value) |
void |
shrink()
Reduces the size of the backing array to the size of the actual items.
|
void |
shuffle() |
void |
sort()
Sorts this array.
|
void |
sort(java.util.Comparator<T> comparator)
Sorts the array.
|
void |
swap(int first,
int second) |
T[] |
toArray() |
<V> V[] |
toArray(java.lang.Class<V> type) |
java.lang.String |
toString() |
java.lang.String |
toString(java.lang.String separator) |
void |
truncate(int newSize)
Reduces the size of the array to the specified size.
|
public T[] items
Array(boolean, int, Class) constructor was used.public int size
public boolean ordered
public Array()
public Array(int capacity)
public Array(boolean ordered,
int capacity)
ordered - If false, methods that remove elements may change the order of other elements in the array, which avoids a
memory copy.capacity - Any elements added beyond this will cause the backing array to be grown.public Array(boolean ordered,
int capacity,
java.lang.Class<T> arrayType)
items of the specified type.ordered - If false, methods that remove elements may change the order of other elements in the array, which avoids a
memory copy.capacity - Any elements added beyond this will cause the backing array to be grown.public Array(java.lang.Class<T> arrayType)
items of the specified type and a capacity of 16.public Array(Array array)
public Array(T[] array)
public Array(boolean ordered,
T[] array)
ordered - If false, methods that remove elements may change the order of other elements in the array, which avoids a
memory copy.public void add(T value)
public void addAll(Array array)
public void addAll(Array array, int offset, int length)
public void addAll(T[] array)
public void addAll(T[] array, int offset, int length)
public T get(int index)
public void set(int index,
T value)
public void insert(int index,
T value)
public void swap(int first,
int second)
public boolean contains(T value, boolean identity)
identity - If true, == comparison will be used. If false, .equals() comparison will be used.public int indexOf(T value, boolean identity)
identity - If true, == comparison will be used. If false, .equals() comparison will be used.public int lastIndexOf(T value, boolean identity)
identity - If true, == comparison will be used. If false, .equals() comparison will be used.public boolean removeValue(T value, boolean identity)
identity - If true, == comparison will be used. If false, .equals() comparison will be used.public T removeIndex(int index)
public boolean removeAll(Array<T> array, boolean identity)
identity - True to use ==, false to use .equals().public T pop()
public T peek()
public T first()
public void clear()
public void shrink()
public T[] ensureCapacity(int additionalCapacity)
itemsprotected T[] resize(int newSize)
public void sort()
Comparable. This method is not thread safe (uses
Sort.instance()).public void sort(java.util.Comparator<T> comparator)
Sort.instance()).public void reverse()
public void shuffle()
public java.util.Iterator<T> iterator()
Array.ArrayIterator constructor for nested or multithreaded iteration.iterator in interface java.lang.Iterable<T>public java.lang.Iterable<T> select(Predicate<T> predicate)
Predicate.PredicateIterable
constructor for nested or multithreaded iteration.public void truncate(int newSize)
public T random()
public T[] toArray()
public <V> V[] toArray(java.lang.Class<V> type)
public boolean equals(java.lang.Object object)
equals in class java.lang.Objectpublic java.lang.String toString()
toString in class java.lang.Objectpublic java.lang.String toString(java.lang.String separator)