Package com.badlogic.gdx.utils
Class ShortArray
- java.lang.Object
-
- com.badlogic.gdx.utils.ShortArray
-
public class ShortArray extends java.lang.ObjectA resizable, ordered or unordered short array. Avoids the boxing that occurs with ArrayList. If unordered, this class avoids a memory copy when removing elements (the last element is moved to the removed element's position).
-
-
Constructor Summary
Constructors Constructor Description ShortArray()Creates an ordered array with a capacity of 16.ShortArray(boolean ordered, int capacity)ShortArray(boolean ordered, short[] array, int startIndex, int count)Creates a new array containing the elements in the specified array.ShortArray(int capacity)Creates an ordered array with the specified capacity.ShortArray(short[] array)Creates a new ordered array containing the elements in the specified array.ShortArray(ShortArray array)Creates a new array containing the elements in the specific array.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description voidadd(int value)Casts the specified value to short and adds it.voidadd(short value)voidadd(short value1, short value2)voidadd(short value1, short value2, short value3)voidadd(short value1, short value2, short value3, short value4)voidaddAll(short... array)voidaddAll(short[] array, int offset, int length)voidaddAll(ShortArray array)voidaddAll(ShortArray array, int offset, int length)voidclear()booleancontains(short value)short[]ensureCapacity(int additionalCapacity)Increases the size of the backing array to accommodate the specified number of additional items.booleanequals(java.lang.Object object)shortfirst()Returns the first item.shortget(int index)inthashCode()voidincr(int index, short value)voidincr(short value)intindexOf(short value)voidinsert(int index, short value)voidinsertRange(int index, int count)Inserts the specified number of items at the specified index.booleanisEmpty()Returns true if the array is empty.intlastIndexOf(char value)voidmul(int index, short value)voidmul(short value)booleannotEmpty()Returns true if the array has one or more items.shortpeek()Returns the last item.shortpop()Removes and returns the last item.shortrandom()Returns a random item from the array, or zero if the array is empty.booleanremoveAll(ShortArray array)Removes from this array all of elements contained in the specified array.shortremoveIndex(int index)Removes and returns the item at the specified index.voidremoveRange(int start, int end)Removes the items between the specified indices, inclusive.booleanremoveValue(short value)protected short[]resize(int newSize)voidreverse()voidset(int index, short value)short[]setSize(int newSize)Sets the array size, leaving any values beyond the current size undefined.short[]shrink()Reduces the size of the backing array to the size of the actual items.voidshuffle()voidsort()voidswap(int first, int second)short[]toArray()java.lang.StringtoString()java.lang.StringtoString(java.lang.String separator)voidtruncate(int newSize)Reduces the size of the array to the specified size.static ShortArraywith(short... array)
-
-
-
Constructor Detail
-
ShortArray
public ShortArray()
Creates an ordered array with a capacity of 16.
-
ShortArray
public ShortArray(int capacity)
Creates an ordered array with the specified capacity.
-
ShortArray
public ShortArray(boolean ordered, int capacity)- Parameters:
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.
-
ShortArray
public ShortArray(ShortArray array)
Creates a new array containing the elements in the specific array. The new array will be ordered if the specific array is ordered. The capacity is set to the number of elements, so any subsequent elements added will cause the backing array to be grown.
-
ShortArray
public ShortArray(short[] array)
Creates a new ordered array containing the elements in the specified array. The capacity is set to the number of elements, so any subsequent elements added will cause the backing array to be grown.
-
ShortArray
public ShortArray(boolean ordered, short[] array, int startIndex, int count)Creates a new array containing the elements in the specified array. The capacity is set to the number of elements, so any subsequent elements added will cause the backing array to be grown.- Parameters:
ordered- If false, methods that remove elements may change the order of other elements in the array, which avoids a memory copy.
-
-
Method Detail
-
add
public void add(int value)
Casts the specified value to short and adds it.
-
add
public void add(short value)
-
add
public void add(short value1, short value2)
-
add
public void add(short value1, short value2, short value3)
-
add
public void add(short value1, short value2, short value3, short value4)
-
addAll
public void addAll(ShortArray array)
-
addAll
public void addAll(ShortArray array, int offset, int length)
-
addAll
public void addAll(short... array)
-
addAll
public void addAll(short[] array, int offset, int length)
-
get
public short get(int index)
-
set
public void set(int index, short value)
-
incr
public void incr(int index, short value)
-
incr
public void incr(short value)
-
mul
public void mul(int index, short value)
-
mul
public void mul(short value)
-
insert
public void insert(int index, short value)
-
insertRange
public void insertRange(int index, int count)Inserts the specified number of items at the specified index. The new items will have values equal to the values at those indices before the insertion.
-
swap
public void swap(int first, int second)
-
contains
public boolean contains(short value)
-
indexOf
public int indexOf(short value)
-
lastIndexOf
public int lastIndexOf(char value)
-
removeValue
public boolean removeValue(short value)
-
removeIndex
public short removeIndex(int index)
Removes and returns the item at the specified index.
-
removeRange
public void removeRange(int start, int end)Removes the items between the specified indices, inclusive.
-
removeAll
public boolean removeAll(ShortArray array)
Removes from this array all of elements contained in the specified array.- Returns:
- true if this array was modified.
-
pop
public short pop()
Removes and returns the last item.
-
peek
public short peek()
Returns the last item.
-
first
public short first()
Returns the first item.
-
notEmpty
public boolean notEmpty()
Returns true if the array has one or more items.
-
isEmpty
public boolean isEmpty()
Returns true if the array is empty.
-
clear
public void clear()
-
shrink
public short[] shrink()
Reduces the size of the backing array to the size of the actual items. This is useful to release memory when many items have been removed, or if it is known that more items will not be added.- Returns:
items
-
ensureCapacity
public short[] ensureCapacity(int additionalCapacity)
Increases the size of the backing array to accommodate the specified number of additional items. Useful before adding many items to avoid multiple backing array resizes.- Returns:
items
-
setSize
public short[] setSize(int newSize)
Sets the array size, leaving any values beyond the current size undefined.- Returns:
items
-
resize
protected short[] resize(int newSize)
-
sort
public void sort()
-
reverse
public void reverse()
-
shuffle
public void shuffle()
-
truncate
public void truncate(int newSize)
Reduces the size of the array to the specified size. If the array is already smaller than the specified size, no action is taken.
-
random
public short random()
Returns a random item from the array, or zero if the array is empty.
-
toArray
public short[] toArray()
-
hashCode
public int hashCode()
- Overrides:
hashCodein classjava.lang.Object
-
equals
public boolean equals(java.lang.Object object)
- Overrides:
equalsin classjava.lang.Object
-
toString
public java.lang.String toString()
- Overrides:
toStringin classjava.lang.Object
-
toString
public java.lang.String toString(java.lang.String separator)
-
with
public static ShortArray with(short... array)
- See Also:
ShortArray(short[])
-
-