Android 中的SparseArray——来源于源代码（翻译）

SparseArray<E>

结构：

      public
classSparseArray<E>

      android.util

类概述：

  
SparseArray 将整数映射到对象。不像一个正常的对象数组,可以有差距指数。它的目的是比使用HashMap更有效的将整数映射到对象。[1]

构造函数：

       public SparseArray()

创建一个没有包含映射的新的SparseArray 

 

public SparseArray(intinitialCapacity)

创建一个不含映射的新的SparseArray ，将任何额外的内存分配给存储指定数量的映射

公共方法：

   public E get(intkey)

   从指定的键获得对象映射，如果没有这样的映射则指定为null

 

       public E get(intkey, E valueIfKeyNotFound)

   从指定的键获得对象映射，如果没有这样的映射则指定对象[1]

 

       public
void delete(intkey)

   如果有指定的键，则删除指定键的映射

 

       public
voidremove(int key)

   别名delete(intkey)    与delete(intkey)一致

 

       public
voidput(int key, E value)

添加一个从指定键映射到指定的值，如果有一个指定键映射值，那么取代它

 

public
intsize()

在当前的SparseArray的存储空间返回键-值映射的数量

 

public
intkeyAt(int index)

给定一个index的范围（0-size()-1）,返回key从当前SparseArray的存储空间键-值映射中index对应的key值

 

public E valueAt(intindex)

给定一个index的范围（0-size()-1）,返回value从当前SparseArray的存储空间键-值映射中index对应的value的值

 

public
voidsetValueAt(int index, E value)

给定一个index的范围（0-size()-1），在当前SparseArray的存储空间中给index对应的value设置一个新value

 

public
intindexOfKey(int key)

返回指定的key对应的索引，如果key不在key-value映射中，则返回负数

 

public
intindexOfValue(E value)

将返回的指定的key 返回一个index,如果没有键映射到指定的值，那么返回负数。小心，这是一个线性搜索，通过key查找，多个key可能映射到相同的值，这将只能找到其中之一。

 

public
voidclear()

从这个SparseArray删除所有键值映射

 

public
voidappend(int key, E value)

把一个键值对放入数组 优化的情况下这键是大于所有现有的数组中的键