android.util
public
class
android.util.SparseArray<E>
SparseArrays map integers to Objects. Unlike a normal array of Objects,
there can be gaps in the indices. It is intended to be more efficient
than using a HashMap to map Integers to Objects.
Summary
Public Constructors
Public Methods
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
toString,
wait,
wait,
wait
Details
Public Constructors
public
SparseArray()
Creates a new SparseArray containing no mappings.
public
SparseArray(int initialCapacity)
Creates a new SparseArray containing no mappings that will not
require any additional memory allocation to store the specified
number of mappings.
Public Methods
public
void
append(int key, E value)
Puts a key/value pair into the array, optimizing for the case where
the key is greater than all existing keys in the array.
public
void
clear()
Removes all key-value mappings from this SparseArray.
public
void
delete(int key)
Removes the mapping from the specified key, if there was any.
public
E
get(int key, E valueIfKeyNotFound)
Gets the Object mapped from the specified key, or the specified Object
if no such mapping has been made.
public
E
get(int key)
Gets the Object mapped from the specified key, or null
if no such mapping has been made.
public
int
indexOfKey(int key)
Returns the index for which
keyAt(int) would return the
specified key, or a negative number if the specified
key is not mapped.
public
int
indexOfValue(E value)
Returns an index for which
valueAt(int) would return the
specified key, or a negative number if no keys map to the
specified value.
Beware that this is a linear search, unlike lookups by key,
and that multiple keys can map to the same value and this will
find only one of them.
public
int
keyAt(int index)
Given an index in the range 0...size()-1
, returns
the key from the index
th key-value mapping that this
SparseArray stores.
public
void
put(int key, E value)
Adds a mapping from the specified key to the specified value,
replacing the previous mapping from the specified key if there
was one.
public
void
remove(int key)
public
void
setValueAt(int index, E value)
Given an index in the range 0...size()-1
, sets a new
value for the index
th key-value mapping that this
SparseArray stores.
public
int
size()
Returns the number of key-value mappings that this SparseArray
currently stores.
public
E
valueAt(int index)
Given an index in the range 0...size()-1
, returns
the value from the index
th key-value mapping that this
SparseArray stores.