Package com.tangosol.util

Class AbstractLongArray<V>

java.lang.Object
com.tangosol.util.AbstractLongArray<V>
All Implemented Interfaces:
LongArray<V>, Serializable, Cloneable, Iterable<V>
Direct Known Subclasses:
AbstractSparseArray, SimpleLongArray
public abstract class AbstractLongArray<V> extends Object implements LongArray<V>
An implementation of portions of the LongArray interface.
Version:
1.00 2002.04.24
Author:
cp
See Also:

  • Nested Class Summary

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

    LongArray.Iterator<V>

  • Field Summary

    Fields inherited from interface com.tangosol.util.LongArray

    NOT_FOUND

  • Constructor Summary

    Constructors
    Constructor
    Description
    AbstractLongArray()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    long
    add(V oValue)
    Add the passed element value to the LongArray and return the index at which the element value was stored.
    void
    clear()
    Remove all nodes from the LongArray.
    AbstractLongArray<V>
    clone()
    Make a clone of the LongArray.
    boolean
    contains(V value)
    Determine if the LongArray contains the specified element.
    boolean
    equals(Object o)
    Test for LongArray equality.
    boolean
    exists(long lIndex)
    Determine if the specified index is in use.
    V
    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.
    int
    hashCode()
    long
    indexOf(V 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(V oValue, long lIndex)
    Return the index in this LongArray of the first occurrence of the specified element such that (index is greater or equal to lIndex), or NOT_FOUND if this LongArray does not contain the specified element.
    boolean
    isEmpty()
    Test for empty LongArray.
    long
    lastIndexOf(V 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(V oValue, long lIndex)
    Return the index in this LongArray of the last occurrence of the specified element such that (index less than or equal to lIndex), or NOT_FOUND if this LongArray does not contain the specified element.
    V
    remove(long lIndex)
    Remove the specified key from the LongArray, returning its associated value.
    void
    remove(long lIndexFrom, long lIndexTo)
    Remove all nodes in the specified range.
    String
    toString()
    Provide a string representation of the LongArray.

    Methods inherited from class java.lang.Object

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

    Methods inherited from interface java.lang.Iterable

    forEach, spliterator

    Methods inherited from interface com.tangosol.util.LongArray

    ceiling, ceilingIndex, floor, floorIndex, iterator, iterator, keys, reverseIterator, reverseIterator, set

  • Constructor Details

    • AbstractLongArray

      public AbstractLongArray()

  • Method Details

    • get

      public V get(long lIndex)
      Return the value stored at the specified index.
      Specified by:
      get in interface LongArray<V>
      Parameters:
      lIndex - a long index value
      Returns:
      the object stored at the specified index, or null

    • add

      public long add(V oValue)
      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<V>
      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)
      Determine if the specified index is in use.
      Specified by:
      exists in interface LongArray<V>
      Parameters:
      lIndex - a long index value
      Returns:
      true if a value (including null) is stored at the specified index, otherwise false

    • remove

      public V remove(long lIndex)
      Remove the specified key from the LongArray, returning its associated value.
      Specified by:
      remove in interface LongArray<V>
      Parameters:
      lIndex - the index of the key to look for in the LongArray
      Returns:
      the associated value (which can be null) or null if the key is not in the LongArray

    • remove

      public void remove(long lIndexFrom, long lIndexTo)
      Remove all nodes in the specified range.
      Specified by:
      remove in interface LongArray<V>
      Parameters:
      lIndexFrom - the floor index
      lIndexTo - the ceiling index (exclusive)

    • contains

      public boolean contains(V value)
      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<V>
      Parameters:
      value - element whose presence in this list is to be tested
      Returns:
      true if this list contains the specified element

    • clear

      public void clear()
      Remove all nodes from the LongArray.
      Specified by:
      clear in interface LongArray<V>

    • isEmpty

      public boolean isEmpty()
      Test for empty LongArray.
      Specified by:
      isEmpty in interface LongArray<V>
      Returns:
      true if LongArray has no nodes

    • getSize

      public int getSize()
      Determine the size of the LongArray.
      Specified by:
      getSize in interface LongArray<V>
      Returns:
      the number of nodes in the LongArray

    • getFirstIndex

      public long getFirstIndex()
      Determine the first index that exists in the LongArray.
      Specified by:
      getFirstIndex in interface LongArray<V>
      Returns:
      the lowest long value that exists in this LongArray, or NOT_FOUND if the LongArray is empty

    • getLastIndex

      public long getLastIndex()
      Determine the last index that exists in the LongArray.
      Specified by:
      getLastIndex in interface LongArray<V>
      Returns:
      the highest long value that exists in this LongArray, or NOT_FOUND if the LongArray is empty

    • indexOf

      public long indexOf(V 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.
      Specified by:
      indexOf in interface LongArray<V>
      Parameters:
      oValue - the object to find index for
      Returns:
      the index of the specified object in the LongArray

    • indexOf

      public long indexOf(V oValue, long lIndex)
      Return the index in this LongArray of the first occurrence of the specified element such that (index is greater or equal to lIndex), or NOT_FOUND if this LongArray does not contain the specified element.
      Specified by:
      indexOf in interface LongArray<V>
      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(V 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.
      Specified by:
      lastIndexOf in interface LongArray<V>
      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(V oValue, long lIndex)
      Return the index in this LongArray of the last occurrence of the specified element such that (index less than or equal to lIndex), or NOT_FOUND if this LongArray does not contain the specified element.
      Specified by:
      lastIndexOf in interface LongArray<V>
      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

    • toString

      public String toString()
      Provide a string representation of the LongArray.
      Specified by:
      toString in interface LongArray<V>
      Overrides:
      toString in class Object
      Returns:
      a human-readable String value describing the LongArray instance

    • equals

      public boolean equals(Object o)
      Test for LongArray equality.
      Specified by:
      equals in interface LongArray<V>
      Overrides:
      equals in class Object
      Parameters:
      o - an Object to compare to this LongArray for equality
      Returns:
      true if the passed Object is a LongArray containing the same indexes and whose elements at those indexes are equal

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • clone

      public AbstractLongArray<V> clone()
      Make a clone of the LongArray. The element values are not deep-cloned.
      Specified by:
      clone in interface LongArray<V>
      Overrides:
      clone in class Object
      Returns:
      a clone of this LongArray object