java.lang.Object
|---ohos.utils.LongPlainArray<E&
public class LongPlainArray<E>
extends Object
implements Cloneable
一个基本的集合类，用于存储使用原始数据类型 long 作为键和任何对象作为值的数据结构。
此类中的值直接存储在数组中，无需包装到其他类型中。 这简化了数据存储结构并节省了内存。 该类中的所有键值对在存储时都是按升序排序的，使用二分查找算法高效查找指定键。 在这样的数据存储结构中，键和值可以基于索引进行迭代。 此类实现 Cloneable 接口并支持存储值的浅拷贝。
使用 LongPlainArray 类时要注意以下几点：
| 修饰符和类型 | 字段 | 描述 |
|---|---|---|
| static int | INVALID_INDEX | 指示索引相关操作使用的无效索引。 |
| 构造函数 | 描述 |
|---|---|
| LongPlainArray() | 用于创建具有初始容量的 LongPlainArray 实例的构造函数。 |
| LongPlainArray(int capacity) | 用于创建具有自定义初始容量的 LongPlainArray 实例的构造函数。 |
| 修饰符和类型 | 方法 | 描述 |
|---|---|---|
| void | append(long key, E value) | 将键值对附加到 LongPlainArray。 |
| void | clear() | 清除当前 LongPlainArray 对象。 |
| LongPlainArrayE | clone() | 获取当前 LongPlainArray 对象的克隆。 |
| boolean | contains(long key) | 检查当前 LongPlainArray 对象是否包含指定的键。 |
| OptionalE | get(long key) | 查询与指定键关联的值。 |
| E | get(long key, E defaultValue) | 使用传递的 defaultValue 参数查询与指定键关联的值。 |
| int | indexOfKey(long key) | 查询指定键的索引。 |
| int | indexOfValue(E value) | 查询指定值的索引。 |
| boolean | isEmpty() | 检查当前 LongPlainArray 对象是否为空。 |
| long | keyAt(int index) | 查询指定索引的键。 |
| int | locate(long key) | 搜索指定键的索引。 |
| void | put(long key, E value) | 将键值对添加到 LongPlainArray。 |
| OptionalE | remove(long key) | 根据指定键删除键值对。 |
| E | removeAt(int index) | 删除指定索引的键值对。 |
| void | setValueAt(int index, E value) | 更新指定索引的值。 |
| int | size() | 获取当前 LongPlainArray 中存储的值的总数。 |
| String | toString() | 获取 LongPlainArray 对象的字符串格式。 |
| E | valueAt(int index) | 查询指定索引的值。 |
| 从类 java.lang.Object 继承的方法 |
|---|
| equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
public static final int INVALID_INDEX
指示索引相关操作使用的无效索引。
public LongPlainArray()
用于创建具有初始容量的 LongPlainArray 实例的构造函数。
public LongPlainArray(int capacity)
用于创建具有自定义初始容量的 LongPlainArray 实例的构造函数。
此构造函数允许您自定义 LongPlainArray 对象的初始容量。
参数：
| 参数名称 | 参数描述 |
|---|---|
| capacity | 指示要为对象自定义的初始容量。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IllegalArgumentException | 如果指定的容量小于或等于 0，则引发此异常。 |
public int locate(long key)
搜索指定键的索引。
二分搜索算法用于搜索。 如果没有找到结果，则返回负值。 但是，您可以将此负值取反以获取该键应存储在数组中的索引。
参数：
| 参数名称 | 参数描述 |
|---|---|
| key | 表示要搜索的键。 |
返回:
返回键的索引； 如果没有找到结果，则返回负值。
public int indexOfKey(long key)
查询指定键的索引。
参数：
| 参数名称 | 参数描述 |
|---|---|
| key | 表示要查询的键。 |
返回:
返回键的索引； 如果查询的键不存在，则返回 INVALID_INDEX。
public int indexOfValue(E value)
查询指定值的索引。
参数：
| 参数名称 | 参数描述 |
|---|---|
| value | 表示要查询的值。 |
返回:
返回值的索引； 如果查询的值不存在，则返回 INVALID_INDEX。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| NullPointerException | 如果查询的值为 null，则抛出此异常。 |
public long keyAt(int index)
查询指定索引的键。
参数：
| 参数名称 | 参数描述 |
|---|---|
| index | 表示要查询的索引。 |
返回:
返回指定索引的键。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IndexOutOfBoundsException | 如果指定的索引超出有效范围，则引发此异常。 |
public E valueAt(int index)
查询指定索引的值。
参数：
| 参数名称 | 参数描述 |
|---|---|
| index | 表示要查询的索引。 |
返回:
返回指定索引的值。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IndexOutOfBoundsException | 如果指定的索引超出有效范围，则引发此异常。 |
public OptionalE get(long key)
查询与指定键关联的值。
参数：
| 参数名称 | 参数描述 |
|---|---|
| key | 表示要查询的值的键。 |
返回:
返回一个包含获得值的 Optional 对象； 如果 key 不存在，则返回一个空的 Optional 对象。
public E get(long key, E defaultValue)
使用传递的 defaultValue 参数查询与指定键关联的值。
参数：
| 参数名称 | 参数描述 |
|---|---|
| key | 表示要查询的值的键。 |
| defaultValue | 表示默认值。 |
返回:
返回键的值； 如果键不存在，则返回 defaultValue。
public void put(long key, E value)
将键值对添加到 LongPlainArray。
如果指定的键已经存在，它的值将被替换为值。
参数：
| 参数名称 | 参数描述 |
|---|---|
| key | 表示要添加的键。 |
| value | 指示与键关联的值。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| NullPointerException | 如果值为 null，则引发此异常。 |
public void setValueAt(int index, E value)
更新指定索引的值。
参数：
| 参数名称 | 参数描述 |
|---|---|
| index | 指示要插入的索引。 |
| value | 指示与键关联的值。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IndexOutOfBoundsException | 如果指定的索引超出有效范围，则引发此异常。 |
| NullPointerException | 如果指定值为 null，则引发此异常。 |
public void append(long key, E value)
将键值对附加到 LongPlainArray。
如果要添加的键大于数组中的任何现有键，则此方法比 put(long,java.lang.Object) 方法更有效。 如果指定的键不是数组中最大的键，则自动调用 put(long,java.lang.Object) 方法添加键值对。
参数：
| 参数名称 | 参数描述 |
|---|---|
| key | 表示要添加的键。 |
| value | 指示与键关联的值。 |
Throws:
| Throw名称 | Throw描述 |
|---|---|
| NullPointerException | 如果值为 null，则引发此异常。 |
public OptionalE remove(long key)
根据指定键删除键值对。
参数：
| 参数名称 | 参数描述 |
|---|---|
| key | 表示要删除的密钥。 |
返回:
返回一个包含已移除值的 Optional 对象； 如果 key 不存在，则返回一个空的 Optional 对象。
public E removeAt(int index)
删除指定索引的键值对。
参数：
| 参数名称 | 参数描述 |
|---|---|
| index | 表示要移除的键值对的索引。 |
返回:
返回一个封装了已移除值的 Optional 对象。
Throws:
| Throw名称 | Throw描述 |
|---|---|
| IndexOutOfBoundsException | 如果指定的索引超出有效范围，则引发此异常。 |
public LongPlainArrayE clone()
获取当前 LongPlainArray 对象的克隆。
请注意，存储在数组中的值是浅拷贝的。
覆盖：
在类 Object 中克隆
返回:
返回 LongPlainArray 对象的克隆。
public boolean contains(long key)
检查当前 LongPlainArray 对象是否包含指定的键。
参数：
| 参数名称 | 参数描述 |
|---|---|
| key | 表示要检查的键。 |
返回:
如果指定的键存在，则返回 true； 否则返回 false。
public void clear()
清除当前 LongPlainArray 对象。
public boolean isEmpty()
检查当前 LongPlainArray 对象是否为空。
返回:
如果不包含任何值，则返回 true； 否则返回 false。
public int size()
获取当前 LongPlainArray 中存储的值的总数。
返回:
返回存储值的总数。
public String toString()
获取 LongPlainArray 对象的字符串格式。
返回的字符串格式符合 JSON，JSON 名称/值对中的值由 LongPlainArray 对象中每个元素的 toString() 方法返回。
覆盖：
类 Object 中的 toString
返回:
返回 LongPlainArray 的基于 JSON 的字符串格式。
备案信息： 粤ICP备15087711号-2
Copyright © 2008-2024 啊嘎哇在线工具箱 All Rights.
本站所有资料来源于网络，版权归原作者所有，仅作学习交流使用，如不慎侵犯了您的权利，请联系我们。