com.tangosol.util

Class ConverterCollections.ConverterLongArray<F,T>

java.lang.Object

com.tangosol.util.ConverterCollections.ConverterLongArray<F,T>

Type Parameters:

F - the type of the provided LongArray

T - the type of the desired type

All Implemented Interfaces:

LongArray<T>, Serializable, Cloneable, Iterable<T>

Enclosing class:

ConverterCollections

public static class ConverterCollections.ConverterLongArray<F,T>
extends Object
implements LongArray<T>

ConverterLongArray converts the value of the LongArray from its raw form (type F) to the desired from (type T).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	ConverterCollections.ConverterLongArray.ConverterLongArrayIterator An Iterator that can convert from raw types to desired types.

Nested classes/interfaces inherited from interface com.tangosol.util.LongArray

LongArray.Iterator<V>

Field Summary

Fields

Modifier and Type	Field and Description
protected Converter<T,F>	f_convDown The Converter to use to convert from type T to type F.
protected Converter<F,T>	f_convUp The Converter to use to convert from type F to type T.
protected LongArray<F>	f_laDelegate The LongArray to delegate to.

Fields inherited from interface com.tangosol.util.LongArray

NOT_FOUND

Constructor Summary

Constructors

Constructor and Description
ConverterLongArray(LongArray<F> laDelegate, Converter<F,T> convUp, Converter<T,F> convDown) Construct a LongArray that converts the values from type F to type T.

Method Summary

Modifier and Type	Method and Description
long	add(T oValue) Add the passed element value to the LongArray and return the index at which the element value was stored.
T	ceiling(long lIndex) Return the "first" value with an index which is greater than or equal to the specified index.
long	ceilingIndex(long lIndex) Return the "first" index which is greater than or equal to the specified index.
void	clear() Remove all nodes from the LongArray.
LongArray<T>	clone() Make a clone of the LongArray.
boolean	contains(T oValue) Determine if the LongArray contains the specified element.
boolean	exists(long lIndex) Determine if the specified index is in use.
T	floor(long lIndex) Return the "first" value with an index which is less than or equal to the specified index.
long	floorIndex(long lIndex) Return the "first" index which is less than or equal to the specified index.
T	get(long lIndex) Return the value stored at the specified index.
long	getFirstIndex() Determine the first index that exists in the LongArray.
long	getLastIndex() Determine the last index that exists in the LongArray.
int	getSize() Determine the size of the LongArray.
long	indexOf(T oValue) Return the index in this LongArray of the first occurrence of the specified element, or NOT_FOUND if this LongArray does not contain the specified element.
long	indexOf(T oValue, long lIndex) Return the index in this LongArray of the first occurrence of the specified element such that (index greater or equal to lIndex), or NOT_FOUND if this LongArray does not contain the specified element.
protected LongArray.Iterator<T>	instantiateIterator(LongArray.Iterator<F> iter) Instantiate a new Iterator wrapping the provided iterator.
boolean	isEmpty() Test for empty LongArray.
LongArray.Iterator<T>	iterator() Obtain a LongArray.Iterator of the contents of the LongArray in order of increasing indices.
LongArray.Iterator<T>	iterator(long lIndex) Obtain a LongArray.Iterator of the contents of the LongArray in order of increasing indices, starting at a particular index such that the first call to next will set the location of the iterator at the first existent index that is greater than or equal to the specified index, or will throw a NoSuchElementException if there is no such existent index.
long	lastIndexOf(T oValue) Return the index in this LongArray of the last occurrence of the specified element, or NOT_FOUND if this LongArray does not contain the specified element.
long	lastIndexOf(T oValue, long lIndex) Return the index in this LongArray of the last occurrence of the specified element such that (index less then or equal to lIndex), or NOT_FOUND if this LongArray does not contain the specified element.
T	remove(long lIndex) Remove the specified index from the LongArray, returning its associated value.
void	remove(long lIndexFrom, long lIndexTo) Remove all nodes in the specified range.
LongArray.Iterator<T>	reverseIterator() Obtain a LongArray.Iterator of the contents of the LongArray in reverse order (decreasing indices).
LongArray.Iterator<T>	reverseIterator(long lIndex) Obtain a LongArray.Iterator of the contents of the LongArray in reverse order (decreasing indices), starting at a particular index such that the first call to next will set the location of the iterator at the first existent index that is less than or equal to the specified index, or will throw a NoSuchElementException if there is no such existent index.
T	set(long lIndex, T oValue) Add the passed item to the LongArray at the specified index.

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.tangosol.util.LongArray

equals, keys, toString

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Detail

f_laDelegate

protected final LongArray<F> f_laDelegate

The LongArray to delegate to.

f_convUp

protected final Converter<F,T> f_convUp

The Converter to use to convert from type F to type T.

f_convDown

protected final Converter<T,F> f_convDown

The Converter to use to convert from type T to type F.

Constructor Detail

ConverterLongArray

public ConverterLongArray(LongArray<F> laDelegate,
                          Converter<F,T> convUp,
                          Converter<T,F> convDown)

Construct a LongArray that converts the values from type F to type T.

Parameters:

laDelegate - the LongArray that stores values of type F

convUp - a Converter that converts up

convDown - a Converter that converts down

Method Detail

get

public T get(long lIndex)

Description copied from interface: LongArray

Return the value stored at the specified index.

Specified by:

get in interface LongArray<T>

Parameters:

lIndex - a long index value

Returns:

the object stored at the specified index, or null

floorIndex

public long floorIndex(long lIndex)

Description copied from interface: LongArray

Return the "first" index which is less than or equal to the specified index.

Specified by:

floorIndex in interface LongArray<T>

Parameters:

lIndex - the index

Returns:

the index or NOT_FOUND

floor

public T floor(long lIndex)

Description copied from interface: LongArray

Return the "first" value with an index which is less than or equal to the specified index.

Specified by:

floor in interface LongArray<T>

Parameters:

lIndex - the index

Returns:

the value or null

ceilingIndex

public long ceilingIndex(long lIndex)

Description copied from interface: LongArray

Return the "first" index which is greater than or equal to the specified index.

Specified by:

ceilingIndex in interface LongArray<T>

Parameters:

lIndex - the index

Returns:

the index or NOT_FOUND

ceiling

public T ceiling(long lIndex)

Description copied from interface: LongArray

Return the "first" value with an index which is greater than or equal to the specified index.

Specified by:

ceiling in interface LongArray<T>

Parameters:

lIndex - the index

Returns:

the value or null

set

public T set(long lIndex,
             T oValue)

Description copied from interface: LongArray

Add the passed item to the LongArray at the specified index.

If the index is already used, the passed value will replace the current value stored with the key, and the replaced value will be returned.

It is expected that LongArray implementations will "grow" as necessary to support the specified index.

Specified by:

set in interface LongArray<T>

Parameters:

lIndex - a long index value

oValue - the object to store at the specified index

Returns:

the object that was stored at the specified index, or null

add

public long add(T oValue)

Description copied from interface: LongArray

Add the passed element value to the LongArray and return the index at which the element value was stored.

Specified by:

add in interface LongArray<T>

Parameters:

oValue - the object to add to the LongArray

Returns:

the long index value at which the element value was stored

exists

public boolean exists(long lIndex)

Description copied from interface: LongArray

Determine if the specified index is in use.

Specified by:

exists in interface LongArray<T>

Parameters:

lIndex - a long index value

Returns:

true if a value (including null) is stored at the specified index, otherwise false

remove

public T remove(long lIndex)

Description copied from interface: LongArray

Remove the specified index from the LongArray, returning its associated value.

Specified by:

remove in interface LongArray<T>

Parameters:

lIndex - the index into the LongArray

Returns:

the associated value (which can be null) or null if the specified index is not in the LongArray

remove

public void remove(long lIndexFrom,
                   long lIndexTo)

Description copied from interface: LongArray

Remove all nodes in the specified range.

Specified by:

remove in interface LongArray<T>

Parameters:

lIndexFrom - the floor index

lIndexTo - the ceiling index (exclusive)

contains

public boolean contains(T oValue)

Description copied from interface: LongArray

Determine if the LongArray contains the specified element.

More formally, returns true if and only if this LongArray contains at least one element e such that (o==null ? e==null : o.equals(e)).

Specified by:

contains in interface LongArray<T>

Parameters:

oValue - element whose presence in this list is to be tested

Returns:

true if this list contains the specified element

clear

public void clear()

Description copied from interface: LongArray

Remove all nodes from the LongArray.

Specified by:

clear in interface LongArray<T>

isEmpty

public boolean isEmpty()

Description copied from interface: LongArray

Test for empty LongArray.

Specified by:

isEmpty in interface LongArray<T>

Returns:

true if LongArray has no nodes

getSize

public int getSize()

Description copied from interface: LongArray

Determine the size of the LongArray.

Specified by:

getSize in interface LongArray<T>

Returns:

the number of nodes in the LongArray

iterator

public LongArray.Iterator<T> iterator()

Description copied from interface: LongArray

Obtain a LongArray.Iterator of the contents of the LongArray in order of increasing indices.

Specified by:

iterator in interface LongArray<T>

Specified by:

iterator in interface Iterable<T>

Returns:

an instance of LongArray.Iterator

iterator

public LongArray.Iterator<T> iterator(long lIndex)

Description copied from interface: LongArray

Obtain a LongArray.Iterator of the contents of the LongArray in order of increasing indices, starting at a particular index such that the first call to next will set the location of the iterator at the first existent index that is greater than or equal to the specified index, or will throw a NoSuchElementException if there is no such existent index.

Specified by:

iterator in interface LongArray<T>

Parameters:

lIndex - the LongArray index to iterate from

Returns:

an instance of LongArray.Iterator

reverseIterator

public LongArray.Iterator<T> reverseIterator()

Description copied from interface: LongArray

Obtain a LongArray.Iterator of the contents of the LongArray in reverse order (decreasing indices).

Specified by:

reverseIterator in interface LongArray<T>

Returns:

an instance of LongArray.Iterator

reverseIterator

public LongArray.Iterator<T> reverseIterator(long lIndex)

Description copied from interface: LongArray

Obtain a LongArray.Iterator of the contents of the LongArray in reverse order (decreasing indices), starting at a particular index such that the first call to next will set the location of the iterator at the first existent index that is less than or equal to the specified index, or will throw a NoSuchElementException if there is no such existent index.

Specified by:

reverseIterator in interface LongArray<T>

Parameters:

lIndex - the LongArray index to iterate from

Returns:

an instance of LongArray.Iterator

getFirstIndex

public long getFirstIndex()

Description copied from interface: LongArray

Determine the first index that exists in the LongArray.

Specified by:

getFirstIndex in interface LongArray<T>

Returns:

the lowest long value that exists in this LongArray, or NOT_FOUND if the LongArray is empty

getLastIndex

public long getLastIndex()

Description copied from interface: LongArray

Determine the last index that exists in the LongArray.

Specified by:

getLastIndex in interface LongArray<T>

Returns:

the highest long value that exists in this LongArray, or NOT_FOUND if the LongArray is empty

indexOf

public long indexOf(T oValue)

Description copied from interface: LongArray

Return the index in this LongArray of the first occurrence of the specified element, or NOT_FOUND if this LongArray does not contain the specified element.

Specified by:

indexOf in interface LongArray<T>

Parameters:

oValue - the object to find index for

Returns:

the index of the specified object in the LongArray

indexOf

public long indexOf(T oValue,
                    long lIndex)

Description copied from interface: LongArray

Return the index in this LongArray of the first occurrence of the specified element such that (index greater or equal to lIndex), or NOT_FOUND if this LongArray does not contain the specified element.

Specified by:

indexOf in interface LongArray<T>

Parameters:

oValue - the object to find the index for

lIndex - the index to compare to

Returns:

the index of the specified object in the LongArray that is greater or equal to the specified index

lastIndexOf

public long lastIndexOf(T oValue)

Description copied from interface: LongArray

Return the index in this LongArray of the last occurrence of the specified element, or NOT_FOUND if this LongArray does not contain the specified element.

Specified by:

lastIndexOf in interface LongArray<T>

Parameters:

oValue - the object to find the index for

Returns:

the index of the last occurrence of the specified object in the LongArray

lastIndexOf

public long lastIndexOf(T oValue,
                        long lIndex)

Description copied from interface: LongArray

Return the index in this LongArray of the last occurrence of the specified element such that (index less then or equal to lIndex), or NOT_FOUND if this LongArray does not contain the specified element.

Specified by:

lastIndexOf in interface LongArray<T>

Parameters:

oValue - the object to find the index for

lIndex - the index to compare to

Returns:

the index of the specified object in this LongArray that is less or equal to the specified index

clone

public LongArray<T> clone()

Description copied from interface: LongArray

Make a clone of the LongArray. The element values are not deep-cloned.

Specified by:

clone in interface LongArray<T>

Overrides:

clone in class Object

Returns:

a clone of this LongArray object

instantiateIterator

protected LongArray.Iterator<T> instantiateIterator(LongArray.Iterator<F> iter)

Instantiate a new Iterator wrapping the provided iterator.

Parameters:

iter - the Iterator to wrap

Returns:

an iterator converting the raw type to the desired type