public interface IntList extends List<Integer>, Comparable<List<? extends Integer>>, IntCollection
List
; provides some additional methods that use polymorphism to avoid (un)boxing.
Note that this type-specific interface extends Comparable
: it is expected that implementing
classes perform a lexicographical comparison using the standard operator "less then" for primitive types,
and the usual compareTo()
method for objects.
Additionally, this interface strengthens listIterator()
,
listIterator(int)
and subList(int,int)
.
Besides polymorphic methods, this interfaces specifies methods to copy into an array or remove contiguous sublists. Although the abstract implementation of this interface provides simple, one-by-one implementations of these methods, it is expected that concrete implementation override them with optimized versions.
List
Modifier and Type | Method and Description |
---|---|
boolean |
add(int key) |
void |
add(int index,
int key) |
boolean |
addAll(int index,
IntCollection c) |
boolean |
addAll(int index,
IntList c) |
boolean |
addAll(IntList c) |
void |
addElements(int index,
int[] a)
Add (hopefully quickly) elements to this type-specific list.
|
void |
addElements(int index,
int[] a,
int offset,
int length)
Add (hopefully quickly) elements to this type-specific list.
|
void |
getElements(int from,
int[] a,
int offset,
int length)
Copies (hopefully quickly) elements of this type-specific list into the given array.
|
int |
getInt(int index) |
int |
indexOf(int k) |
IntListIterator |
intListIterator()
Deprecated.
As of
fastutil 5, replaced by listIterator() . |
IntListIterator |
intListIterator(int index)
Deprecated.
As of
fastutil 5, replaced by listIterator(int) . |
IntList |
intSubList(int from,
int to)
Deprecated.
As of
fastutil 5, replaced by subList(int,int) . |
IntListIterator |
iterator()
Returns a type-specific iterator on the elements of this list (in proper sequence).
|
int |
lastIndexOf(int k) |
IntListIterator |
listIterator()
Returns a type-specific list iterator on the list.
|
IntListIterator |
listIterator(int index)
Returns a type-specific list iterator on the list starting at a given index.
|
void |
removeElements(int from,
int to)
Removes (hopefully quickly) elements of this type-specific list.
|
int |
removeInt(int index) |
int |
set(int index,
int k) |
void |
size(int size)
Sets the size of this list.
|
IntList |
subList(int from,
int to)
Returns a type-specific view of the portion of this list from the index
from , inclusive, to the index to , exclusive. |
add, add, addAll, addAll, clear, contains, containsAll, equals, get, hashCode, indexOf, isEmpty, lastIndexOf, remove, remove, removeAll, retainAll, set, size, toArray, toArray
compareTo
addAll, contains, containsAll, intIterator, rem, removeAll, retainAll, toArray, toArray, toIntArray, toIntArray
IntListIterator iterator()
List.iterator()
.
It would not be normally necessary, but Iterable.iterator()
is bizarrily re-specified
in List
.iterator
in interface Collection<Integer>
iterator
in interface IntCollection
iterator
in interface IntIterable
iterator
in interface Iterable<Integer>
iterator
in interface List<Integer>
@Deprecated IntListIterator intListIterator()
listIterator()
@Deprecated IntListIterator intListIterator(int index)
listIterator(int)
IntListIterator listIterator()
listIterator
in interface List<Integer>
List.listIterator()
IntListIterator listIterator(int index)
listIterator
in interface List<Integer>
List.listIterator(int)
@Deprecated IntList intSubList(int from, int to)
from
, inclusive, to the index to
, exclusive.List.subList(int,int)
IntList subList(int from, int to)
from
, inclusive, to the index to
, exclusive.
Note that this specification strengthens the one given in List.subList(int,int)
.
subList
in interface List<Integer>
List.subList(int,int)
void size(int size)
If the specified size is smaller than the current size, the last elements are
discarded. Otherwise, they are filled with 0/null
/false
.
size
- the new size.void getElements(int from, int[] a, int offset, int length)
from
- the start index (inclusive).a
- the destination array.offset
- the offset into the destination array where to store the first element copied.length
- the number of elements to be copied.void removeElements(int from, int to)
from
- the start index (inclusive).to
- the end index (exclusive).void addElements(int index, int[] a)
index
- the index at which to add elements.a
- the array containing the elements.void addElements(int index, int[] a, int offset, int length)
index
- the index at which to add elements.a
- the array containing the elements.offset
- the offset of the first element to add.length
- the number of elements to add.boolean add(int key)
add
in interface IntCollection
List.add(Object)
void add(int index, int key)
List.add(int,Object)
boolean addAll(int index, IntCollection c)
List.add(int,Object)
boolean addAll(int index, IntList c)
List.add(int,Object)
boolean addAll(IntList c)
List.add(int,Object)
int getInt(int index)
List.get(int)
int indexOf(int k)
List.indexOf(Object)
int lastIndexOf(int k)
List.lastIndexOf(Object)
int removeInt(int index)
List.remove(int)
int set(int index, int k)
List.set(int,Object)