Android 中的SparseArray——来源于源代码(翻译)

时间:2021-12-16 23:26:35

SparseArray<E>



结构:

      publicclassSparseArray<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]

 

       publicvoid delete(intkey)

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

 

       publicvoidremove(int key)

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

 

       publicvoidput(int key, E value)

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

 

publicintsize()

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

 

publicintkeyAt(int index)

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

 

public E valueAt(intindex)

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

 

publicvoidsetValueAt(int index, E value)

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

 

publicintindexOfKey(int key)

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

 

publicintindexOfValue(E value)

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

 

publicvoidclear()

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

 

publicvoidappend(int key, E value)

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