org.joda.primitives.collection.impl

Class ArrayIntCollection

java.lang.Object

org.joda.primitives.collection.impl.AbstractPrimitiveCollectable<java.lang.Integer>

org.joda.primitives.collection.impl.AbstractIntCollection

org.joda.primitives.collection.impl.ArrayIntCollection

All Implemented Interfaces:

java.lang.Cloneable, java.lang.Iterable<java.lang.Integer>, java.util.Collection<java.lang.Integer>, IntCollection, PrimitiveCollection<java.lang.Integer>, IntIterable, PrimitiveCollectable<java.lang.Integer>

public class ArrayIntCollection
extends AbstractIntCollection
implements java.lang.Cloneable

Array based implementation of IntCollection for primitive int elements.

This collection implementation allows multiple copies of the same value to be added. Internally, it uses an array, and behaves much like a list.

This class implements Collection allowing seamless integration with other APIs.

Add, Remove and Clear are supported.

Since:

1.0

Version:

CODE GENERATED

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	ArrayIntCollection.PIterator Iterator.

Constructor Summary

Constructors

Constructor and Description
ArrayIntCollection() Constructor.
ArrayIntCollection(java.util.Collection<?> coll) Constructs a new collection by copying values from another collection.
ArrayIntCollection(int initialSize) Constructor that defines an initial size for the internal storage array.
ArrayIntCollection(int[] values) Constructor that copies the specified values.
ArrayIntCollection(java.util.Iterator<java.lang.Integer> it) Constructs a new collection by copying values from an iterator.

Method Summary

Modifier and Type	Method and Description
boolean	add(int value) Adds a primitive value to this collection.
boolean	addAll(int[] values) Adds an array of primitive values to this collection.
boolean	addAll(IntCollection values) Adds a collection of primitive values to this collection.
boolean	addAll(int startInclusive, int endInclusive) Adds a range of primitive values to this collection.
protected void	arrayCopy(int fromIndex, int[] dest, int destIndex, int size) Copies data from this collection into the specified array.
void	clear() Clears the collection of all elements.
java.lang.Object	clone() Clone implementation that calls Object clone().
boolean	contains(int value) Checks whether this collection contains a specified primitive value.
protected boolean	doAdd(int index, int[] values) Internal implementation to add to this collection at the specified index.
protected void	doRemoveIndex(int index) Internal implementation to remove the element at the specified index.
protected void	ensureCapacity(int reqCapacity) Internal implementation to ensure that the internal storage array has at least the specified size.
protected boolean	isAddModifiable() Are the add methods supported.
boolean	isModifiable() Checks whether the object can currently be modified.
protected boolean	isRemoveModifiable() Are the remove methods supported.
IntIterator	iterator() Gets an iterator over this collection capable of accessing the primitive values.
void	optimize() Optimizes the implementation.
int	size() Gets the current size of the collection.

Methods inherited from class org.joda.primitives.collection.impl.AbstractIntCollection

add, addAll, checkAddModifiable, checkRemoveModifiable, contains, containsAll, containsAll, containsAll, containsAll, containsAny, containsAny, containsAny, containsAny, isToPrimitivePossible, remove, removeAll, removeAll, removeAll, removeAll, removeAll, removeFirst, retainAll, retainAll, retainAll, retainAll, toArray, toArray, toIntArray, toIntArray, toObject, toPrimitive, toPrimitiveArray, toString

Methods inherited from class org.joda.primitives.collection.impl.AbstractPrimitiveCollectable

isEmpty

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.joda.primitives.PrimitiveCollectable

isEmpty

Methods inherited from interface java.util.Collection

equals, hashCode, isEmpty, parallelStream, removeIf, spliterator, stream

Methods inherited from interface java.lang.Iterable

forEach

Constructor Detail

ArrayIntCollection

public ArrayIntCollection()

Constructor.

ArrayIntCollection

public ArrayIntCollection(int initialSize)

Constructor that defines an initial size for the internal storage array.

Parameters:

initialSize - the initial size of the internal array, negative treated as zero

ArrayIntCollection

public ArrayIntCollection(int[] values)

Constructor that copies the specified values.

Parameters:

values - an array of values to copy, null treated as zero size array

ArrayIntCollection

public ArrayIntCollection(java.util.Collection<?> coll)

Constructs a new collection by copying values from another collection.

Parameters:

coll - a collection of values to copy, null treated as zero size collection

ArrayIntCollection

public ArrayIntCollection(java.util.Iterator<java.lang.Integer> it)

Constructs a new collection by copying values from an iterator.

Parameters:

it - an iterator of values to extract, null treated as zero size collection

Method Detail

size

public int size()

Gets the current size of the collection.

Specified by:

size in interface java.util.Collection<java.lang.Integer>

Specified by:

size in interface PrimitiveCollectable<java.lang.Integer>

Returns:

the current size

iterator

public IntIterator iterator()

Gets an iterator over this collection capable of accessing the primitive values.

Specified by:

iterator in interface java.lang.Iterable<java.lang.Integer>

Specified by:

iterator in interface java.util.Collection<java.lang.Integer>

Specified by:

iterator in interface IntCollection

Specified by:

iterator in interface IntIterable

Returns:

an iterator over this collection

add

public boolean add(int value)

Adds a primitive value to this collection.

Specified by:

add in interface IntCollection

Overrides:

add in class AbstractIntCollection

Parameters:

value - the value to add to this collection

Returns:

true if this collection was modified by this method call

Throws:

java.lang.IllegalArgumentException - if value is rejected by this collection

optimize

public void optimize()

Optimizes the implementation.

This implementation changes the internal array to be the same size as the size of the collection.

Specified by:

optimize in interface PrimitiveCollectable<java.lang.Integer>

Overrides:

optimize in class AbstractPrimitiveCollectable<java.lang.Integer>

isAddModifiable

protected boolean isAddModifiable()

Are the add methods supported.

Overrides:

isAddModifiable in class AbstractIntCollection

Returns:

true

isRemoveModifiable

protected boolean isRemoveModifiable()

Are the remove methods supported.

Overrides:

isRemoveModifiable in class AbstractIntCollection

Returns:

true

isModifiable

public boolean isModifiable()

Checks whether the object can currently be modified.

Specified by:

isModifiable in interface PrimitiveCollectable<java.lang.Integer>

Overrides:

isModifiable in class AbstractIntCollection

Returns:

true

contains

public boolean contains(int value)

Checks whether this collection contains a specified primitive value.

This implementation uses the internal array directly.

Specified by:

contains in interface IntCollection

Overrides:

contains in class AbstractIntCollection

Parameters:

value - the value to search for

Returns:

true if the value is found

clear

public void clear()

Clears the collection of all elements. The collection will have a zero size after this method completes.

This implementation resets the size, but does not reduce the internal storage array.

Specified by:

clear in interface java.util.Collection<java.lang.Integer>

Specified by:

clear in interface PrimitiveCollectable<java.lang.Integer>

Overrides:

clear in class AbstractIntCollection

addAll

public boolean addAll(int[] values)

Adds an array of primitive values to this collection.

Specified by:

addAll in interface IntCollection

Overrides:

addAll in class AbstractIntCollection

Parameters:

values - the values to add to this collection

Returns:

true if this collection was modified by this method call

addAll

public boolean addAll(IntCollection values)

Adds a collection of primitive values to this collection.

Specified by:

addAll in interface IntCollection

Overrides:

addAll in class AbstractIntCollection

Parameters:

values - the values to add to this collection, null treated as empty collection

Returns:

true if this collection was modified by this method call

addAll

public boolean addAll(int startInclusive,
                      int endInclusive)

Adds a range of primitive values to this collection.

The range is defined to be inclusive of the start and end. If the start is greater than the end then the range is equivalent to an empty collection.

Specified by:

addAll in interface IntCollection

Overrides:

addAll in class AbstractIntCollection

Parameters:

startInclusive - the inclusive range start value

endInclusive - the inclusive range end value

Returns:

true if this collection was modified by this method call

Throws:

java.lang.IllegalArgumentException - if a value is rejected by this set

java.lang.UnsupportedOperationException - if not supported by this set

clone

public java.lang.Object clone()

Clone implementation that calls Object clone().

Specified by:

clone in interface PrimitiveCollectable<java.lang.Integer>

Overrides:

clone in class AbstractPrimitiveCollectable<java.lang.Integer>

Returns:

the clone

arrayCopy

protected void arrayCopy(int fromIndex,
                         int[] dest,
                         int destIndex,
                         int size)

Copies data from this collection into the specified array. This method is pre-validated.

Overrides:

arrayCopy in class AbstractIntCollection

Parameters:

fromIndex - the index to start from

dest - the destination array

destIndex - the destination start index

size - the number of items to copy

doAdd

protected boolean doAdd(int index,
                        int[] values)

Internal implementation to add to this collection at the specified index. This method adjusts the capacity and size.

Parameters:

index - the index to add at, valid

values - the array to add, not null

Returns:

true if the array was updated

doRemoveIndex

protected void doRemoveIndex(int index)

Internal implementation to remove the element at the specified index.

Parameters:

index - the index, valid

ensureCapacity

protected void ensureCapacity(int reqCapacity)

Internal implementation to ensure that the internal storage array has at least the specified size.

Parameters:

reqCapacity - the amount to expand to