org.gridgain.grid.util

Class GridLongList

java.lang.Object

org.gridgain.grid.util.GridLongList

All Implemented Interfaces:

Externalizable, Serializable

public class GridLongList
extends Object
implements Externalizable

Minimal list API to work with primitive longs. This list exists to avoid boxing/unboxing when using standard list from Java.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
GridLongList()
GridLongList(int size)
GridLongList(long[] arr)

Method Summary

Methods

Modifier and Type	Method and Description
void	add(long x) Add element to this array.
void	addAll(GridLongList l)
static GridLongList	addAll(GridLongList to, GridLongList from)
static GridLongList	asList(long... vals)
boolean	contains(long l)
boolean	containsAll(GridLongList l)
GridLongList	copy()
GridLongList	copyWithout(GridLongList l) Returns (possibly reordered) copy of this list, excluding all elements of given list.
boolean	distinct()
boolean	equals(Object o)
long	get(int i)
int	hashCode()
long[]	internalArray()
boolean	isEmpty()
void	readExternal(ObjectInput in)
static GridLongList	readFrom(DataInput in)
long	remove() Removes and returns the last element of the list.
long	removeIndex(int i) Removes element by given index.
int	removeValue(int startIdx, long val) Removes value from this list.
int	replaceValue(int startIdx, long oldVal, long newVal) Removes value from this list.
int	size()
GridLongList	sort() Sorts this list.
String	toString()
void	truncate(int size, boolean last)
void	writeExternal(ObjectOutput out)
static void	writeTo(DataOutput out, GridLongList list)

Methods inherited from class java.lang.Object

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

Constructor Detail

GridLongList

public GridLongList()

GridLongList

public GridLongList(int size)

Parameters:

size - Size.

GridLongList

public GridLongList(long[] arr)

Parameters:

arr - Array.

Method Detail

asList

public static GridLongList asList(long... vals)

Parameters:

vals - Values.

Returns:

List from values.

copy

public GridLongList copy()

Returns:

Copy of this list.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

addAll

public void addAll(GridLongList l)

Parameters:

l - List to add all elements of.

add

public void add(long x)

Add element to this array.

Parameters:

x - Value.

remove

public long remove()
            throws NoSuchElementException

Removes and returns the last element of the list. Complementary method to add(long) for stack like usage.

Returns:

Removed element.

Throws:

NoSuchElementException - If the list is empty.

copyWithout

public GridLongList copyWithout(GridLongList l)

Returns (possibly reordered) copy of this list, excluding all elements of given list.

Parameters:

l - List of elements to remove.

Returns:

New list without all elements from l.

get

public long get(int i)

Parameters:

i - Index.

Returns:

Value.

size

public int size()

Returns:

Size.

isEmpty

public boolean isEmpty()

Returns:

True if this list has no elements.

contains

public boolean contains(long l)

Parameters:

l - Element to find.

Returns:

True if found.

containsAll

public boolean containsAll(GridLongList l)

Parameters:

l - List to check.

Returns:

True if this list contains all the elements of passed in list.

distinct

public boolean distinct()

Returns:

True if there are no duplicates.

truncate

public void truncate(int size,
            boolean last)

Parameters:

size - New size.

last - If true the last elements will be removed, otherwise the first.

removeIndex

public long removeIndex(int i)

Removes element by given index.

Parameters:

i - Index.

Returns:

Removed value.

removeValue

public int removeValue(int startIdx,
              long val)

Removes value from this list.

Parameters:

startIdx - Index to begin search with.

val - Value.

Returns:

Index of removed value if the value was found and removed or -1 otherwise.

replaceValue

public int replaceValue(int startIdx,
               long oldVal,
               long newVal)

Removes value from this list.

Parameters:

startIdx - Index to begin search with.

oldVal - Old value.

newVal - New value.

Returns:

Index of replaced value if the value was found and replaced or -1 otherwise.

internalArray

public long[] internalArray()

Returns:

Internal array.

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException

Specified by:

writeExternal in interface Externalizable

Throws:

IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException

Specified by:

readExternal in interface Externalizable

Throws:

IOException

ClassNotFoundException

toString

public String toString()

Overrides:

toString in class Object

readFrom

@Nullable
public static GridLongList readFrom(DataInput in)
                             throws IOException

Parameters:

in - Input to read list from.

Returns:

Grid long list.

Throws:

IOException - If failed.

writeTo

public static void writeTo(DataOutput out,
           @Nullable
           GridLongList list)
                    throws IOException

Parameters:

out - Output to write to.

list - List.

Throws:

IOException - If failed.

addAll

public static GridLongList addAll(@Nullable
                  GridLongList to,
                  GridLongList from)

Parameters:

to - To list.

from - From list.

Returns:

To list (passed in or created).

sort

public GridLongList sort()

Sorts this list. Use copy().sort() if you need a defensive copy.

Returns:

this For chaining.