org.mini2Dx.core.collections.concurrent

Class ConcurrentDelayedRemovalArray<T>

java.lang.Object

org.mini2Dx.gdx.utils.Array<T>

org.mini2Dx.gdx.utils.DelayedRemovalArray<T>

org.mini2Dx.core.collections.concurrent.ConcurrentDelayedRemovalArray<T>

All Implemented Interfaces:

java.lang.Iterable<T>, ConcurrentCollection

public class ConcurrentDelayedRemovalArray<T>
extends org.mini2Dx.gdx.utils.DelayedRemovalArray<T>
implements ConcurrentCollection

Nested Class Summary

Nested classes/interfaces inherited from class org.mini2Dx.gdx.utils.Array

org.mini2Dx.gdx.utils.Array.ArrayIterable<T>, org.mini2Dx.gdx.utils.Array.ArrayIterator<T>

Field Summary

Fields

Modifier and Type	Field and Description
protected ReadWriteLock	lock

Fields inherited from class org.mini2Dx.gdx.utils.Array

items, ordered, size

Constructor Summary

Constructors

Constructor and Description
ConcurrentDelayedRemovalArray()
ConcurrentDelayedRemovalArray(org.mini2Dx.gdx.utils.Array<? extends T> array) NOTE: read access to the other array is not thread-safe
ConcurrentDelayedRemovalArray(boolean ordered, int capacity)
ConcurrentDelayedRemovalArray(boolean ordered, int capacity, java.lang.Class arrayType)
ConcurrentDelayedRemovalArray(boolean ordered, T[] array, int startIndex, int count)
ConcurrentDelayedRemovalArray(java.lang.Class arrayType)
ConcurrentDelayedRemovalArray(int capacity)
ConcurrentDelayedRemovalArray(T[] array)

Method Summary

Modifier and Type	Method and Description
void	add(T value)
void	add(T value1, T value2)
void	add(T value1, T value2, T value3)
void	add(T value1, T value2, T value3, T value4)
void	addAll(org.mini2Dx.gdx.utils.Array<? extends T> array, int start, int count)
void	addAll(T[] array, int start, int count)
void	begin()
void	clear()
boolean	contains(T value, boolean identity) Returns true if this array contains the specified value.
boolean	containsAll(org.mini2Dx.gdx.utils.Array<? extends T> values, boolean identity) Returns true if this array contains all the specified values.
boolean	containsAny(org.mini2Dx.gdx.utils.Array<? extends T> values, boolean identity) Returns true if this array contains any the specified values.
void	end()
T[]	ensureCapacity(int additionalCapacity) Increases the size of the backing array to accommodate the specified number of additional items.
boolean	equals(java.lang.Object object) Returns false if either array is unordered.
boolean	equalsIdentity(java.lang.Object object) Uses == for comparison of each item.
T	first() Returns the first item.
T	get(int index)
ReadWriteLock	getLock() Returns the collection's ReadWriteLock
int	hashCode()
int	indexOf(T value, boolean identity) Returns the index of first occurrence of value in the array, or -1 if no such value exists.
void	insert(int index, T value)
boolean	isEmpty() Returns true if the array is empty.
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.
boolean	notEmpty() Returns true if the array has one or more items.
T	peek() Returns the last item.
T	pop()
T	random() Returns a random item from the array, or null if the array is empty.
boolean	removeAll(org.mini2Dx.gdx.utils.Array<? extends T> array, boolean identity) Removes from this array all of elements contained in the specified array.
T	removeIndex(int index)
void	removeRange(int start, int end)
boolean	removeValue(T value, boolean identity)
void	reverse()
java.lang.Iterable<T>	select(org.mini2Dx.gdx.utils.Predicate<T> predicate) Returns an iterable for the selected items in the array.
T	selectRanked(java.util.Comparator<T> comparator, int kthLowest) Selects the nth-lowest element from the Array according to Comparator ranking.
int	selectRankedIndex(java.util.Comparator<T> comparator, int kthLowest)
void	set(int index, T value)
T[]	setSize(int newSize)
T[]	shrink() Reduces the size of the backing array to the size of the actual items.
void	shuffle()
void	sort()
void	sort(java.util.Comparator<? super T> comparator)
void	swap(int first, int second)
T[]	toArray() Returns the items as an array.
<V> V[]	toArray(java.lang.Class<V> type)
java.lang.String	toString()
java.lang.String	toString(java.lang.String separator)
void	truncate(int newSize)

Methods inherited from class org.mini2Dx.gdx.utils.DelayedRemovalArray

with

Methods inherited from class org.mini2Dx.gdx.utils.Array

addAll, addAll, of, of, resize

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

lock

protected ReadWriteLock lock

Constructor Detail

ConcurrentDelayedRemovalArray

public ConcurrentDelayedRemovalArray()

ConcurrentDelayedRemovalArray

public ConcurrentDelayedRemovalArray(org.mini2Dx.gdx.utils.Array<? extends T> array)

NOTE: read access to the other array is not thread-safe

Parameters:

array -

ConcurrentDelayedRemovalArray

public ConcurrentDelayedRemovalArray(boolean ordered,
                                     int capacity,
                                     java.lang.Class arrayType)

ConcurrentDelayedRemovalArray

public ConcurrentDelayedRemovalArray(boolean ordered,
                                     int capacity)

ConcurrentDelayedRemovalArray

public ConcurrentDelayedRemovalArray(boolean ordered,
                                     T[] array,
                                     int startIndex,
                                     int count)

ConcurrentDelayedRemovalArray

public ConcurrentDelayedRemovalArray(java.lang.Class arrayType)

ConcurrentDelayedRemovalArray

public ConcurrentDelayedRemovalArray(int capacity)

ConcurrentDelayedRemovalArray

public ConcurrentDelayedRemovalArray(T[] array)

Method Detail

begin

public void begin()

Overrides:

begin in class org.mini2Dx.gdx.utils.DelayedRemovalArray<T>

end

public void end()

Overrides:

end in class org.mini2Dx.gdx.utils.DelayedRemovalArray<T>

removeValue

public boolean removeValue(T value,
                           boolean identity)

Overrides:

removeValue in class org.mini2Dx.gdx.utils.DelayedRemovalArray<T>

removeIndex

public T removeIndex(int index)

Overrides:

removeIndex in class org.mini2Dx.gdx.utils.DelayedRemovalArray<T>

removeRange

public void removeRange(int start,
                        int end)

Overrides:

removeRange in class org.mini2Dx.gdx.utils.DelayedRemovalArray<T>

clear

public void clear()

Overrides:

clear in class org.mini2Dx.gdx.utils.DelayedRemovalArray<T>

set

public void set(int index,
                T value)

Overrides:

set in class org.mini2Dx.gdx.utils.DelayedRemovalArray<T>

insert

public void insert(int index,
                   T value)

Overrides:

insert in class org.mini2Dx.gdx.utils.DelayedRemovalArray<T>

swap

public void swap(int first,
                 int second)

Overrides:

swap in class org.mini2Dx.gdx.utils.DelayedRemovalArray<T>

pop

public T pop()

Overrides:

pop in class org.mini2Dx.gdx.utils.DelayedRemovalArray<T>

sort

public void sort()

Overrides:

sort in class org.mini2Dx.gdx.utils.DelayedRemovalArray<T>

sort

public void sort(java.util.Comparator<? super T> comparator)

Overrides:

sort in class org.mini2Dx.gdx.utils.DelayedRemovalArray<T>

reverse

public void reverse()

Overrides:

reverse in class org.mini2Dx.gdx.utils.DelayedRemovalArray<T>

shuffle

public void shuffle()

Overrides:

shuffle in class org.mini2Dx.gdx.utils.DelayedRemovalArray<T>

truncate

public void truncate(int newSize)

Overrides:

truncate in class org.mini2Dx.gdx.utils.DelayedRemovalArray<T>

setSize

public T[] setSize(int newSize)

Overrides:

setSize in class org.mini2Dx.gdx.utils.DelayedRemovalArray<T>

add

public void add(T value)

Overrides:

add in class org.mini2Dx.gdx.utils.Array<T>

add

public void add(T value1,
                T value2)

Overrides:

add in class org.mini2Dx.gdx.utils.Array<T>

add

public void add(T value1,
                T value2,
                T value3)

Overrides:

add in class org.mini2Dx.gdx.utils.Array<T>

add

public void add(T value1,
                T value2,
                T value3,
                T value4)

Overrides:

add in class org.mini2Dx.gdx.utils.Array<T>

addAll

public void addAll(org.mini2Dx.gdx.utils.Array<? extends T> array,
                   int start,
                   int count)

Overrides:

addAll in class org.mini2Dx.gdx.utils.Array<T>

addAll

public void addAll(T[] array,
                   int start,
                   int count)

Overrides:

addAll in class org.mini2Dx.gdx.utils.Array<T>

get

public T get(int index)

Overrides:

get in class org.mini2Dx.gdx.utils.Array<T>

contains

public boolean contains(T value,
                        boolean identity)

Returns true if this array contains the specified value.

Overrides:

contains in class org.mini2Dx.gdx.utils.Array<T>

Parameters:

value - May be null.

identity - If true, == comparison will be used. If false, .equals() comparison will be used.

containsAll

public boolean containsAll(org.mini2Dx.gdx.utils.Array<? extends T> values,
                           boolean identity)

Returns true if this array contains all the specified values.

Overrides:

containsAll in class org.mini2Dx.gdx.utils.Array<T>

Parameters:

values - May contains nulls.

identity - If true, == comparison will be used. If false, .equals() comparison will be used.

containsAny

public boolean containsAny(org.mini2Dx.gdx.utils.Array<? extends T> values,
                           boolean identity)

Returns true if this array contains any the specified values.

Overrides:

containsAny in class org.mini2Dx.gdx.utils.Array<T>

Parameters:

values - May contains nulls.

identity - If true, == comparison will be used. If false, .equals() comparison will be used.

indexOf

public int indexOf(T value,
                   boolean identity)

Returns the index of first occurrence of value in the array, or -1 if no such value exists.

Overrides:

indexOf in class org.mini2Dx.gdx.utils.Array<T>

Parameters:

value - May be null.

identity - If true, == comparison will be used. If false, .equals() comparison will be used.

Returns:

An index of first occurrence of value in array or -1 if no such value exists

lastIndexOf

public int lastIndexOf(T value,
                       boolean identity)

Returns an index of last occurrence of value in array or -1 if no such value exists. Search is started from the end of an array.

Overrides:

lastIndexOf in class org.mini2Dx.gdx.utils.Array<T>

Parameters:

value - May be null.

identity - If true, == comparison will be used. If false, .equals() comparison will be used.

Returns:

An index of last occurrence of value in array or -1 if no such value exists

removeAll

public boolean removeAll(org.mini2Dx.gdx.utils.Array<? extends T> array,
                         boolean identity)

Removes from this array all of elements contained in the specified array.

Overrides:

removeAll in class org.mini2Dx.gdx.utils.Array<T>

Parameters:

array -

identity - True to use ==, false to use .equals().

Returns:

true if this array was modified.

peek

public T peek()

Returns the last item.

Overrides:

peek in class org.mini2Dx.gdx.utils.Array<T>

first

public T first()

Returns the first item.

Overrides:

first in class org.mini2Dx.gdx.utils.Array<T>

notEmpty

public boolean notEmpty()

Returns true if the array has one or more items.

Overrides:

notEmpty in class org.mini2Dx.gdx.utils.Array<T>

isEmpty

public boolean isEmpty()

Returns true if the array is empty.

Overrides:

isEmpty in class org.mini2Dx.gdx.utils.Array<T>

shrink

public T[] 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.

Overrides:

shrink in class org.mini2Dx.gdx.utils.Array<T>

Returns:

Array.items

ensureCapacity

public T[] 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.

Overrides:

ensureCapacity in class org.mini2Dx.gdx.utils.Array<T>

Parameters:

additionalCapacity -

Returns:

Array.items

selectRanked

public T selectRanked(java.util.Comparator<T> comparator,
                      int kthLowest)

Selects the nth-lowest element from the Array according to Comparator ranking. This might partially sort the Array. The array must have a size greater than 0, or a GdxRuntimeException will be thrown.

Overrides:

selectRanked in class org.mini2Dx.gdx.utils.Array<T>

Parameters:

comparator - used for comparison

kthLowest - rank of desired object according to comparison, n is based on ordinal numbers, not array indices. for min value use 1, for max value use size of array, using 0 results in runtime exception.

Returns:

the value of the Nth lowest ranked object.

See Also:

Select

selectRankedIndex

public int selectRankedIndex(java.util.Comparator<T> comparator,
                             int kthLowest)

Overrides:

selectRankedIndex in class org.mini2Dx.gdx.utils.Array<T>

Parameters:

comparator - used for comparison

kthLowest - rank of desired object according to comparison, n is based on ordinal numbers, not array indices. for min value use 1, for max value use size of array, using 0 results in runtime exception.

Returns:

the index of the Nth lowest ranked object.

See Also:

Array.selectRanked(Comparator, int)

iterator

public java.util.Iterator<T> iterator()

Returns an iterator for the items in the array. Remove is supported.

Specified by:

iterator in interface java.lang.Iterable<T>

Overrides:

iterator in class org.mini2Dx.gdx.utils.Array<T>

select

public java.lang.Iterable<T> select(org.mini2Dx.gdx.utils.Predicate<T> predicate)

Returns an iterable for the selected items in the array. Remove is supported, but not between hasNext() and next().

If Collections.allocateIterators is false, the same iterable instance is returned each time this method is called. Use the Predicate.PredicateIterable constructor for nested or multithreaded iteration.

Overrides:

select in class org.mini2Dx.gdx.utils.Array<T>

Parameters:

predicate -

random

public T random()

Returns a random item from the array, or null if the array is empty.

Overrides:

random in class org.mini2Dx.gdx.utils.Array<T>

toArray

public T[] toArray()

Returns the items as an array. Note the array is typed, so the ConcurrentDelayedRemovalArray(Class) constructor must have been used. Otherwise use toArray(Class) to specify the array type.

Overrides:

toArray in class org.mini2Dx.gdx.utils.Array<T>

toArray

public <V> V[] toArray(java.lang.Class<V> type)

Overrides:

toArray in class org.mini2Dx.gdx.utils.Array<T>

hashCode

public int hashCode()

Overrides:

hashCode in class org.mini2Dx.gdx.utils.Array<T>

equals

public boolean equals(java.lang.Object object)

Returns false if either array is unordered.

Overrides:

equals in class org.mini2Dx.gdx.utils.Array<T>

Parameters:

object -

equalsIdentity

public boolean equalsIdentity(java.lang.Object object)

Uses == for comparison of each item. Returns false if either array is unordered.

Overrides:

equalsIdentity in class org.mini2Dx.gdx.utils.Array<T>

Parameters:

object -

toString

public java.lang.String toString()

Overrides:

toString in class org.mini2Dx.gdx.utils.Array<T>

toString

public java.lang.String toString(java.lang.String separator)

Overrides:

toString in class org.mini2Dx.gdx.utils.Array<T>

getLock

public ReadWriteLock getLock()

Description copied from interface: ConcurrentCollection

Returns the collection's ReadWriteLock

Specified by:

getLock in interface ConcurrentCollection

Returns:

the collection's ReadWriteLock