public class TLongArrayList extends Objectimplements TLongList , Externalizable
| Modifier and Type | Field and Description |
|---|---|
protected long[] |
_data
the data of the list
|
protected int |
_pos
the index after the last entry in the list
|
protected static int |
DEFAULT_CAPACITY
the default capacity for new lists
|
protected long |
no_entry_value
the long value that represents null
|
| Modifier | Constructor and Description |
|---|---|
|
TLongArrayList()
Creates a new
TLongArrayList instance with the default capacity.
|
|
TLongArrayList(int capacity)
Creates a new
TLongArrayList instance with the specified capacity.
|
|
TLongArrayList(int capacity, long no_entry_value)
Creates a new
TLongArrayList instance with the specified capacity.
|
|
TLongArrayList(long[] values)
Creates a new
TLongArrayList instance whose capacity is the length of
values array and whose initial contents are the specified values.
|
protected |
TLongArrayList(long[] values, long no_entry_value, boolean wrap)
|
|
TLongArrayList(TLongCollection
Creates a new
TLongArrayList instance that contains a copy of the collection passed to us.
|
| Modifier and Type | Method and Description |
|---|---|
boolean |
add(long val)
Adds
val to the end of the list, growing as needed.
|
void |
add(long[] vals)
Adds the values in the array
vals to the end of the list, in order.
|
void |
add(long[] vals, int offset, int length)
Adds a subset of the values in the array
vals to the end of the list, in order.
|
boolean |
addAll(Collection
Adds all of the elements in
collection to the collection.
|
boolean |
addAll(long[] array)
Adds all of the elements in the
array to the collection.
|
boolean |
addAll(TLongCollection
Adds all of the elements in the
TLongCollection to the collection.
|
int |
binarySearch(long value)
Performs a binary search for
value in the entire list.
|
int |
binarySearch(long value, int fromIndex, int toIndex)
Performs a binary search for
value in the specified range.
|
void |
clear()
Flushes the internal state of the list, resetting the capacity to the default.
|
void |
clear(int capacity)
Flushes the internal state of the list, setting the capacity of the empty list to
capacity.
|
boolean |
contains(long value)
Searches the list for
value
|
boolean |
containsAll(Collection
Tests the collection to determine if all of the elements in
collection are present.
|
boolean |
containsAll(long[] array)
Tests the collection to determine if all of the elements in
array are present.
|
boolean |
containsAll(TLongCollection
Tests the collection to determine if all of the elements in
TLongCollection are present.
|
void |
ensureCapacity(int capacity)
Grow the internal array as needed to accommodate the specified number of elements.
|
boolean |
equals(Object
Compares the specified object with this collection for equality.
|
void |
fill(int fromIndex, int toIndex, long val)
Fills a range in the list with the specified value.
|
void |
fill(long val)
Fills every slot in the list with the specified value.
|
boolean |
forEach(TLongProcedure
Applies the procedure to each value in the list in ascending (front to back) order.
|
boolean |
forEachDescending(TLongProcedure
Applies the procedure to each value in the list in descending (back to front) order.
|
long |
get(int offset)
Returns the value at the specified offset.
|
long |
getNoEntryValue()
Returns the value that is used to represent null.
|
long |
getQuick(int offset)
Returns the value at the specified offset without doing any bounds checking.
|
TLongList |
grep(TLongProcedure
Searches the list for values satisfying
condition in the manner of the *nix
grep utility.
|
int |
hashCode()
Returns the hash code value for this collection.
|
int |
indexOf(int offset, long value)
Searches the list front to back for the index of
value, starting at
offset.
|
int |
indexOf(long value)
Searches the list front to back for the index of
value.
|
void |
insert(int offset, long value)
Inserts
value into the list at
offset.
|
void |
insert(int offset, long[] values)
Inserts the array of
values into the list at
offset.
|
void |
insert(int offset, long[] values, int valOffset, int len)
Inserts a slice of the array of
values into the list at
offset.
|
TLongList |
inverseGrep(TLongProcedure
Searches the list for values which do
not satisfy
condition.
|
boolean |
isEmpty()
Tests whether this list contains any values.
|
TLongIterator |
iterator()
Creates an iterator over the values of the collection.
|
int |
lastIndexOf(int offset, long value)
Searches the list back to front for the last index of
value, starting at
offset.
|
int |
lastIndexOf(long value)
Searches the list back to front for the last index of
value.
|
long |
max()
Finds the maximum value in the list.
|
long |
min()
Finds the minimum value in the list.
|
void |
readExternal(ObjectInput
|
void |
remove(int offset, int length)
Removes
length values from the list, starting at
offset
|
boolean |
remove(long value)
Removes
value from the list.
|
boolean |
removeAll(Collection
Removes all of the elements in
collection from the collection.
|
boolean |
removeAll(long[] array)
Removes all of the elements in
array from the collection.
|
boolean |
removeAll(TLongCollection
Removes all of the elements in
TLongCollection from the collection.
|
long |
removeAt(int offset)
Removes
value at a given offset from the list.
|
long |
replace(int offset, long val)
Sets the value at the specified offset and returns the previously stored value.
|
void |
reset()
Sets the size of the list to 0, but does not change its capacity.
|
void |
resetQuick()
Sets the size of the list to 0, but does not change its capacity.
|
boolean |
retainAll(Collection
Removes any values in the collection which are not contained in
collection.
|
boolean |
retainAll(long[] array)
Removes any values in the collection which are not contained in
array.
|
boolean |
retainAll(TLongCollection
Removes any values in the collection which are not contained in
TLongCollection.
|
void |
reverse()
Reverse the order of the elements in the list.
|
void |
reverse(int from, int to)
Reverse the order of the elements in the range of the list.
|
long |
set(int offset, long val)
Sets the value at the specified offset.
|
void |
set(int offset, long[] values)
Replace the values in the list starting at
offset with the contents of the
values array.
|
void |
set(int offset, long[] values, int valOffset, int length)
Replace the values in the list starting at
offset with
length values from the
values array, starting at valOffset.
|
void |
setQuick(int offset, long val)
Sets the value at the specified offset without doing any bounds checking.
|
void |
shuffle(Random
Shuffle the elements of the list using the specified random number generator.
|
int |
size()
Returns the number of values in the list.
|
void |
sort()
Sort the values in the list (ascending) using the Sun quicksort implementation.
|
void |
sort(int fromIndex, int toIndex)
Sort a slice of the list (ascending) using the Sun quicksort implementation.
|
TLongList |
subList(int begin, int end)
Returns a sublist of this list.
|
long |
sum()
Calculates the sum of all the values in the list.
|
long[] |
toArray()
Copies the contents of the list into a native array.
|
long[] |
toArray(int offset, int len)
Copies a slice of the list into a native array.
|
long[] |
toArray(long[] dest)
Copies a slice of the list into a native array.
|
long[] |
toArray(long[] dest, int offset, int len)
Copies a slice of the list into a native array.
|
long[] |
toArray(long[] dest, int source_pos, int dest_pos, int len)
Copies a slice of the list into a native array.
|
String |
toString()
|
void |
transformValues(TLongFunction
Transform each value in the list using the specified function.
|
void |
trimToSize()
Sheds any excess capacity above and beyond the current size of the list.
|
static TLongArrayList |
wrap(long[] values)
Returns a primitive List implementation that wraps around the given primitive array.
|
static TLongArrayList |
wrap(long[] values, long no_entry_value)
Returns a primitive List implementation that wraps around the given primitive array.
|
void |
writeExternal(ObjectOutput
|
protected long[] _data
protected int _pos
protected static final int DEFAULT_CAPACITY
protected long no_entry_value
public TLongArrayList()
TLongArrayList instance with the default capacity.
public TLongArrayList(int capacity)
TLongArrayList instance with the specified capacity.
capacity - an
int value
public TLongArrayList(int capacity,
long no_entry_value)
TLongArrayList instance with the specified capacity.
capacity - an
int value
no_entry_value - an
long value that represents null.
public TLongArrayList(TLongCollectioncollection)
TLongArrayList instance that contains a copy of the collection passed to us.
collection - the collection to copy
public TLongArrayList(long[] values)
TLongArrayList instance whose capacity is the length of
values array and whose initial contents are the specified values.
A defensive copy of the given values is held by the new instance.
values - an
long[] value
protected TLongArrayList(long[] values,
long no_entry_value,
boolean wrap)public static TLongArrayListwrap(long[] values)
values -
public static TLongArrayListwrap(long[] values, long no_entry_value)
values -
no_entry_value -
public long getNoEntryValue()
getNoEntryValue in interface
TLongList
getNoEntryValue in interface
TLongCollection
public void ensureCapacity(int capacity)
public int size()
size in interface
TLongList
size in interface
TLongCollection
public boolean isEmpty()
isEmpty in interface
TLongList
isEmpty in interface
TLongCollection
public void trimToSize()
public boolean add(long val)
add in interface
TLongList
add in interface
TLongCollection
val - an
long value
public void add(long[] vals)
public void add(long[] vals,
int offset,
int length)
public void insert(int offset,
long value)
public void insert(int offset,
long[] values)
public void insert(int offset,
long[] values,
int valOffset,
int len)
public long get(int offset)
public long getQuick(int offset)
public long set(int offset,
long val)
public long replace(int offset,
long val)
public void set(int offset,
long[] values)
public void set(int offset,
long[] values,
int valOffset,
int length)
public void setQuick(int offset,
long val)
public void clear()
public void clear(int capacity)
public void reset()
clear() method if you want to recycle a list without allocating new backing arrays.
public void resetQuick()
clear() method if you want to recycle a list without allocating new backing arrays. This method differs from
reset() in that it does not clear the old values in the backing array. Thus, it is possible for getQuick to return stale data if this method is used and the caller is careless about bounds checking.
public boolean remove(long value)
remove in interface
TLongList
remove in interface
TLongCollection
value - an
long value
public long removeAt(int offset)
public void remove(int offset,
int length)
public TLongIteratoriterator()
iterator in interface
TLongCollection
TLongIterator value
public boolean containsAll(Collection<?> collection)
containsAll in interface
TLongCollection
collection - a
Collection value
public boolean containsAll(TLongCollectioncollection)
containsAll in interface
TLongCollection
collection - a
TLongCollection value
public boolean containsAll(long[] array)
containsAll in interface
TLongCollection
array - as
array of long primitives.
public boolean addAll(Collection<? extends Long > collection)
addAll in interface
TLongCollection
collection - a
Collection value
public boolean addAll(TLongCollectioncollection)
addAll in interface
TLongCollection
collection - a
TLongCollection value
public boolean addAll(long[] array)
addAll in interface
TLongCollection
array - a
array of long primitives.
public boolean retainAll(Collection<?> collection)
retainAll in interface
TLongCollection
collection - a
Collection value
public boolean retainAll(TLongCollectioncollection)
retainAll in interface
TLongCollection
collection - a
TLongCollection value
public boolean retainAll(long[] array)
retainAll in interface
TLongCollection
array - an
array of long primitives.
public boolean removeAll(Collection<?> collection)
removeAll in interface
TLongCollection
collection - a
Collection value
public boolean removeAll(TLongCollectioncollection)
removeAll in interface
TLongCollection
collection - a
TLongCollection value
public boolean removeAll(long[] array)
removeAll in interface
TLongCollection
array - an
array of long primitives.
public void transformValues(TLongFunctionfunction)
transformValues in interface
TLongList
function - a
TLongFunction value
public void reverse()
public void reverse(int from,
int to)
public void shuffle(Randomrand)
public TLongListsubList(int begin, int end)
public long[] toArray()
toArray in interface
TLongList
toArray in interface
TLongCollection
long[] value
public long[] toArray(int offset,
int len)
public long[] toArray(long[] dest)
If the list fits in the specified array with room to spare (i.e., the array has more elements than the list), the element in the array immediately following the end of the list is set to TLongList. (This is useful in determining the length of the list only if the caller knows that the list does not contain any "null" elements.)
NOTE: Trove does not allocate a new array if the array passed in is not large enough to hold all of the data elements. It will instead fill the array passed in.
toArray in interface
TLongList
toArray in interface
TLongCollection
dest - the array to copy into.
public long[] toArray(long[] dest,
int offset,
int len)
public long[] toArray(long[] dest,
int source_pos,
int dest_pos,
int len)
public boolean equals(Objectother)
equals in interface
TLongCollection
equals in class
Object
other - object to be compared for equality with this collection
public int hashCode()
Object.hashCode() .
hashCode in interface
TLongCollection
hashCode in class
Object
Object.equals(Object) ,
Collection.equals(Object)
public boolean forEach(TLongProcedureprocedure)
forEach in interface
TLongList
forEach in interface
TLongCollection
procedure - a
TLongProcedure value
public boolean forEachDescending(TLongProcedureprocedure)
forEachDescending in interface
TLongList
procedure - a
TLongProcedure value
public void sort()
sort in interface
TLongList
Arrays.sort(int[])
public void sort(int fromIndex,
int toIndex)
sort in interface
TLongList
fromIndex - the index at which to start sorting (inclusive)
toIndex - the index at which to stop sorting (exclusive)
Arrays.sort(int[])
public void fill(long val)
public void fill(int fromIndex,
int toIndex,
long val)
public int binarySearch(long value)
binarySearch in interface
TLongList
value - the value to search for
public int binarySearch(long value,
int fromIndex,
int toIndex)
binarySearch in interface
TLongList
value - the value to search for
fromIndex - the lower boundary of the range (inclusive)
toIndex - the upper boundary of the range (exclusive)
public int indexOf(long value)
indexOf in interface
TLongList
value - an
long value
for faster searches on sorted lists
public int indexOf(int offset,
long value)
indexOf in interface
TLongList
offset - the offset at which to start the linear search (inclusive)
value - an
long value
for faster searches on sorted lists
public int lastIndexOf(long value)
lastIndexOf in interface
TLongList
value - an
long value
for faster searches on sorted lists
public int lastIndexOf(int offset,
long value)
lastIndexOf in interface
TLongList
offset - the offset at which to start the linear search (exclusive)
value - an
long value
for faster searches on sorted lists
public boolean contains(long value)
contains in interface
TLongList
contains in interface
TLongCollection
value - an
long value
public TLongListgrep(TLongProcedure condition)
public TLongListinverseGrep(TLongProcedure condition)
grep -v.
inverseGrep in interface
TLongList
condition - a condition to apply to each element in the list
public long max()
public long min()
public long sum()
public StringtoString()
public void writeExternal(ObjectOutputout) throws IOException
writeExternal in interface
Externalizable
IOException
public void readExternal(ObjectInputin) throws IOException , ClassNotFoundException
readExternal in interface
Externalizable
IOException
ClassNotFoundException