ArrayMap

ArrayMap

ArrayMap ()

创建一个新的空ArrayMap。 数组映射的默认容量为0，并且一旦添加项目就会增加。

ArrayMap

ArrayMap (int capacity)

用给定的初始容量创建一个新的ArrayMap。

ArrayMap

ArrayMap (ArrayMap<K, V> map)

使用给定ArrayMap的映射创建一个新的ArrayMap。

clear

void clear ()

使数组映射为空。 所有存储都被释放。

containsAll

boolean containsAll (Collection<?> collection)

确定数组映射是否包含给定集合中的所有键。

containsKey

boolean containsKey (Object key)

检查数组中是否存在密钥。

containsValue

boolean containsValue (Object value)

检查数组中是否存在值。 这需要对整个阵列进行线性搜索。

ensureCapacity

void ensureCapacity (int minimumCapacity)

确保数组映射至少可以容纳 minimumCapacity项目。

entrySet

Set<Entry<K, V>> entrySet ()

返回一个 Set用于遍历数组映射中的所有映射并与其进行交互。

注意：这是访问数组内容的非常低效的方式，它需要生成大量临时对象并分配与该容器关联的附加状态信息，这些信息将在容器的使用期限内保留。

注意：

equals

boolean equals (Object object)

指示其他某个对象是否“等于”这一个。

equals方法在非空对象引用上实现等价关系：

• It is reflexive: for any non-null reference value x, x.equals(x) should return true.
• It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
• It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
• It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
• For any non-null reference value x, x.equals(null) should return false.

equals类的方法Object实现了对象上最可能的等价关系; 也就是说，对于任何非空参考值x和y ，当且仅当x和y引用同一对象（ x == y的值为true ）时，此方法返回true 。

请注意，无论何时覆盖此方法，通常都需要覆盖 hashCode方法，以便维护 hashCode方法的一般合同，该方法声明等同对象必须具有相同的散列代码。

如果对象不是地图，或者地图的大小不同，则此实现返回false。 否则，对于此映射中的每个键，都将比较两个映射的值。 如果任何键的值不相等，则该方法返回false，否则返回true。

get

V get (Object key)

从数组中检索一个值。

hashCode

int hashCode ()

返回对象的哈希码值。 为了散列表的好处而支持此方法，例如由HashMap提供的HashMap 。

hashCode的总合同是：

• Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
• If two objects are equal according to the equals(Object) method, then calling the hashCode method on each of the two objects must produce the same integer result.
• It is not required that if two objects are unequal according to the equals(java.lang.Object) method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

尽可能合理实用，由类Object定义的hashCode方法确实为不同的对象返回不同的整数。 （这通常通过将对象的内部地址转换为整数来实现，但Java ^TM编程语言不需要此实现技术。）

indexOfKey

int indexOfKey (Object key)

返回集合中某个键的索引。

isEmpty

boolean isEmpty ()

如果数组映射不包含项目，则返回true。

keyAt

K keyAt (int index)

返回数组中给定索引处的键。

keySet

Set<K> keySet ()

返回一个 Set迭代并与数组映射中的所有键进行交互。

注意：这是访问数组内容的一种相当低效的方式，它需要生成许多临时对象并分配与该容器关联的附加状态信息，这些信息将在容器的使用期限内保留。

put

V put (K key, 
                V value)

给数组映射添加一个新值。

putAll

void putAll (ArrayMap<? extends K, ? extends V> array)

在 数组中执行所有键/值对的 put(Object, Object)

putAll

void putAll (Map<? extends K, ? extends V> map)

在 地图中执行所有键/值对的 put(Object, Object)

remove

V remove (Object key)

从阵列图中删除现有的键。

removeAll

boolean removeAll (Collection<?> collection)

删除给定集合中存在的数组映射中的所有键。

removeAt

V removeAt (int index)

删除给定索引处的键/值映射。

retainAll

boolean retainAll (Collection<?> collection)

删除数组映射中 不存在于给定集合中的所有键。

setValueAt

V setValueAt (int index, 
                V value)

将值设置为数组中的给定索引。

size

int size ()

返回此数组映射中的项目数。

toString

String toString ()

返回对象的字符串表示形式。 通常， toString方法将返回一个字符串，“文本地表示”该对象。 结果应该是一个简洁但内容丰富的表述，对于一个人来说很容易阅读。 建议所有子类重写此方法。

类Object的toString方法返回一个字符串，其中包含对象为实例的类的名称，符号字符“ @ ”和对象的哈希代码的无符号十六进制表示形式。 换句话说，这个方法返回一个字符串，其值等于：

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

该实现通过遍历其映射来组成一个字符串。 如果此映射包含自身作为键或值，则字符串“（此映射）”将出现在它的位置。

valueAt

V valueAt (int index)

返回数组中给定索引的值。

values

Collection<V> values ()

返回一个 Collection迭代并与数组映射中的所有值进行交互。

注意：这是访问数组内容的一种相当低效的方式，它需要生成许多临时对象并分配与该容器关联的附加状态信息，这些信息将在容器的使用期限内保留。