鸿蒙OS LongPlainArray

LongPlainArray

java.lang.Object

|—ohos.utils.LongPlainArray<E&

public class LongPlainArray<E>
extends Object
implements Cloneable

一个基本的集合类，用于存储使用原始数据类型 long 作为键和任何对象作为值的数据结构。

此类中的值直接存储在数组中，无需包装到其他类型中。 这简化了数据存储结构并节省了内存。 该类中的所有键值对在存储时都是按升序排序的，使用二分查找算法高效查找指定键。 在这样的数据存储结构中，键和值可以基于索引进行迭代。 此类实现 Cloneable 接口并支持存储值的浅拷贝。

使用 LongPlainArray 类时要注意以下几点：

• 这个类是非线程安全的。
• 存储的值不能是空对象。
• 值的存储顺序与插入时不同。

字段摘要

构造函数摘要

方法总结

字段详细信息

INVALID_INDEX

public static final int INVALID_INDEX

指示索引相关操作使用的无效索引。

构造函数详细信息

LongPlainArray

public LongPlainArray()

用于创建具有初始容量的 LongPlainArray 实例的构造函数。

LongPlainArray

public LongPlainArray(int capacity)

用于创建具有自定义初始容量的 LongPlainArray 实例的构造函数。

此构造函数允许您自定义 LongPlainArray 对象的初始容量。

参数：

Throws:

方法详情

locate

public int locate(long key)

搜索指定键的索引。

二分搜索算法用于搜索。 如果没有找到结果，则返回负值。 但是，您可以将此负值取反以获取该键应存储在数组中的索引。

参数：

返回:

返回键的索引； 如果没有找到结果，则返回负值。

indexOfKey

public int indexOfKey(long key)

查询指定键的索引。

参数：

返回:

返回键的索引； 如果查询的键不存在，则返回 INVALID_INDEX。

indexOfValue

public int indexOfValue(E value)

查询指定值的索引。

参数：

返回:

返回值的索引； 如果查询的值不存在，则返回 INVALID_INDEX。

Throws:

keyAt

public long keyAt(int index)

查询指定索引的键。

参数：

返回:

返回指定索引的键。

Throws:

valueAt

public E valueAt(int index)

查询指定索引的值。

参数：

返回:

返回指定索引的值。

Throws:

get

public OptionalE get(long key)

查询与指定键关联的值。

参数：

返回:

返回一个包含获得值的 Optional 对象； 如果 key 不存在，则返回一个空的 Optional 对象。

get

public E get(long key, E defaultValue)

使用传递的 defaultValue 参数查询与指定键关联的值。

参数：

返回:

返回键的值； 如果键不存在，则返回 defaultValue。

put

public void put(long key, E value)

将键值对添加到 LongPlainArray。

如果指定的键已经存在，它的值将被替换为值。

参数：

Throws:

setValueAt

public void setValueAt(int index, E value)

更新指定索引的值。

参数：

Throws:

append

public void append(long key, E value)

将键值对附加到 LongPlainArray。

如果要添加的键大于数组中的任何现有键，则此方法比 put(long,java.lang.Object) 方法更有效。 如果指定的键不是数组中最大的键，则自动调用 put(long,java.lang.Object) 方法添加键值对。

参数：

Throws:

remove

public OptionalE remove(long key)

根据指定键删除键值对。

参数：

返回:

返回一个包含已移除值的 Optional 对象； 如果 key 不存在，则返回一个空的 Optional 对象。

removeAt

public E removeAt(int index)

删除指定索引的键值对。

参数：

返回:

返回一个封装了已移除值的 Optional 对象。

Throws:

clone

public LongPlainArrayE clone()

获取当前 LongPlainArray 对象的克隆。

请注意，存储在数组中的值是浅拷贝的。

覆盖：

在类 Object 中克隆

返回:

返回 LongPlainArray 对象的克隆。

contains

public boolean contains(long key)

检查当前 LongPlainArray 对象是否包含指定的键。

参数：

返回:

如果指定的键存在，则返回 true； 否则返回 false。

clear

public void clear()

清除当前 LongPlainArray 对象。

isEmpty

public boolean isEmpty()

检查当前 LongPlainArray 对象是否为空。

返回:

如果不包含任何值，则返回 true； 否则返回 false。

size

public int size()

获取当前 LongPlainArray 中存储的值的总数。

返回:

返回存储值的总数。

toString

public String toString()

获取 LongPlainArray 对象的字符串格式。

返回的字符串格式符合 JSON，JSON 名称/值对中的值由 LongPlainArray 对象中每个元素的 toString() 方法返回。

覆盖：

类 Object 中的 toString

返回:

返回 LongPlainArray 的基于 JSON 的字符串格式。