PlainBooleanArray
java.lang.Object
|—ohos.utils.PlainBooleanArray
public class PlainBooleanArray
extends Object
implements Cloneable
一个基本的集合类,用于存储使用原始数据类型 int 作为键和 boolean 作为值的数据结构。
此类中的值直接存储在数组中,无需包装到其他类型或自动装箱。 这简化了数据存储结构并节省了内存。 该类中的所有key在存储时都是按升序排序的,使用二分查找算法高效查找指定key。 在这样的数据存储结构中,键和值可以基于索引进行迭代。 这个类实现了 Cloneable 接口。
使用 PlainBooleanArray 类时要注意以下几点:
- 这个类是非线程安全的。
- 值的存储顺序与插入时不同。
字段摘要
修饰符和类型 | 字段 | 描述 |
---|---|---|
static int | INVALID_INDEX | 指示索引相关操作使用的无效索引。 |
构造函数摘要
构造函数 | 描述 |
---|---|
PlainBooleanArray() | 用于创建 PlainBooleanArray 实例的默认构造函数。 |
PlainBooleanArray(int capacity) | 用于创建具有自定义初始容量的 PlainBooleanArray 实例的构造函数。 |
方法总结
修饰符和类型 | 方法 | 描述 |
---|---|---|
void | append(int key, boolean value) | 将键值对附加到 PlainBooleanArray。 |
void | clear() | 清除存储在当前 PlainBooleanArray 对象中的所有键值对。 |
PlainBooleanArray | clone() | 创建当前 PlainBooleanArray 对象的克隆。 |
boolean | contains(int key) | 检查当前的 PlainBooleanArray 对象是否包含指定的键。 |
OptionalBoolean | get(int key) | 查询与指定键关联的值。 |
boolean | get(int key, boolean defaultValue) | 使用传递的 defaultValue 参数查询与指定键关联的值。 |
int | indexOfKey(int key) | 查询指定键的索引。 |
int | indexOfValue(boolean value) | 查询指定值的索引。 |
boolean | isEmpty() | 检查当前的 PlainBooleanArray 对象是否为空。 |
int | keyAt(int index) | 查询指定索引处的键。 |
int | locate(int key) | 搜索指定键的索引。 |
void | put(int key, boolean value) | 将键值对添加到 PlainBooleanArray。 |
OptionalBoolean | remove(int key) | 根据指定键删除键值对。 |
OptionalBoolean | removeAt(int index) | 删除指定索引处的键值对。 |
void | setValueAt(int index, boolean value) | 更新指定索引处的值。 |
int | size() | 获取当前 PlainBooleanArray 中存储的值的总数。 |
String | toString() | 获取 PlainBooleanArray 对象的字符串表示形式。 |
boolean | valueAt(int index) | 查询指定索引处的值。 |
从类 java.lang.Object 继承的方法 |
---|
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
字段详细信息
INVALID_INDEX
public static final int INVALID_INDEX
指示索引相关操作使用的无效索引。
构造函数详细信息
PlainBooleanArray
public PlainBooleanArray()
用于创建 PlainBooleanArray 实例的默认构造函数。
PlainBooleanArray
public PlainBooleanArray(int capacity)
用于创建具有自定义初始容量的 PlainBooleanArray 实例的构造函数。
此构造函数允许您自定义 PlainBooleanArray 对象的初始容量。
参数:
参数名称 | 参数描述 |
---|---|
capacity | 指示要为对象自定义的初始容量。 |
Throws:
Throw名称 | Throw描述 |
---|---|
IllegalArgumentException | 如果指定的容量小于或等于 0,则引发此异常。 |
方法详情
locate
public int locate(int key)
搜索指定键的索引。
二分搜索算法用于搜索。 如果没有找到结果,则返回负值。 但是,您可以将此负值取反以获取该键应存储在数组中的索引。
参数:
参数名称 | 参数描述 |
---|---|
key | 表示要搜索的键。 |
返回:
返回键的索引; 如果没有找到结果,则返回负值。
append
public void append(int key, boolean value)
将键值对附加到 PlainBooleanArray。
如果要添加的键大于数组中的任何现有键,则此方法比 put(int,boolean) 方法更有效。 如果指定的键不是数组中最大的键,则自动调用 put(int,boolean) 方法添加键值对。
参数:
参数名称 | 参数描述 |
---|---|
key | 表示要添加的键。 |
value | 指示与键关联的值。 |
clear
public void clear()
清除存储在当前 PlainBooleanArray 对象中的所有键值对。
clone
public PlainBooleanArray clone()
创建当前 PlainBooleanArray 对象的克隆。
覆盖:
在类 Object 中克隆
返回:
返回 PlainBooleanArray 对象的克隆。
get
public OptionalBoolean get(int key)
查询与指定键关联的值。
参数:
参数名称 | 参数描述 |
---|---|
key | 表示要查询的值的键。 |
返回:
返回一个包含获得值的 Optional 对象; 如果 key 不存在,则返回一个空的 Optional 对象。
get
public boolean get(int key, boolean defaultValue)
使用传递的 defaultValue 参数查询与指定键关联的值。
参数:
参数名称 | 参数描述 |
---|---|
key | 表示要查询的值的键。 |
defaultValue | 表示默认值。 |
返回:
返回键的值; 如果键不存在,则返回 defaultValue。
indexOfKey
public int indexOfKey(int key)
查询指定键的索引。
参数:
参数名称 | 参数描述 |
---|---|
key | 表示要查询的键。 |
返回:
返回键的索引; 如果查询的键不存在,则返回 INVALID_INDEX。
indexOfValue
public int indexOfValue(boolean value)
查询指定值的索引。
参数:
参数名称 | 参数描述 |
---|---|
value | 表示要查询的值。 |
返回:
如果找到多个值,则返回第一个匹配值的索引; 如果查询的值不存在,则返回 INVALID_INDEX。
keyAt
public int keyAt(int index)
查询指定索引处的键。
参数:
参数名称 | 参数描述 |
---|---|
index | 表示要查询的索引。 |
返回:
返回指定索引处的键。
Throws:
Throw名称 | Throw描述 |
---|---|
IndexOutOfBoundsException | 如果指定的索引超出有效范围,则引发此异常。 |
valueAt
public boolean valueAt(int index)
查询指定索引处的值。
参数:
参数名称 | 参数描述 |
---|---|
index | 表示要查询的索引。 |
返回:
返回指定索引处的值。
Throws:
Throw名称 | Throw描述 |
---|---|
IndexOutOfBoundsException | 如果指定的索引超出有效范围,则引发此异常。 |
put
public void put(int key, boolean value)
将键值对添加到 PlainBooleanArray。
如果指定的键已经存在,它的值将被替换为值。
参数:
参数名称 | 参数描述 |
---|---|
key | 表示要添加的键。 |
value | 指示与键关联的值。 |
setValueAt
public void setValueAt(int index, boolean value)
更新指定索引处的值。
参数:
参数名称 | 参数描述 |
---|---|
index | 指示要更新的值的索引。 |
value | 表示新值。 |
Throws:
Throw名称 | Throw描述 |
---|---|
IndexOutOfBoundsException | 如果指定的索引超出有效范围,则引发此异常。 |
remove
public OptionalBoolean remove(int key)
根据指定键删除键值对。
参数:
参数名称 | 参数描述 |
---|---|
key | 表示要删除的密钥。 |
返回:
返回一个包含已移除值的 Optional 对象; 如果 key 不存在,则返回一个空的 Optional 对象。
removeAt
public OptionalBoolean removeAt(int index)
删除指定索引处的键值对。
参数:
参数名称 | 参数描述 |
---|---|
index | 表示要移除的键值对的索引。 |
返回:
返回包含已删除值的 Optional 对象。
Throws:
Throw名称 | Throw描述 |
---|---|
IndexOutOfBoundsException | 如果指定的索引超出有效范围,则引发此异常。 |
size
public int size()
获取当前 PlainBooleanArray 中存储的值的总数。
返回:
返回存储值的总数。
isEmpty
public boolean isEmpty()
检查当前的 PlainBooleanArray 对象是否为空。
返回:
如果不包含任何值,则返回 true; 否则返回 false。
contains
public boolean contains(int key)
检查当前的 PlainBooleanArray 对象是否包含指定的键。
参数:
参数名称 | 参数描述 |
---|---|
key | 表示要检查的键。 |
返回:
如果指定的键存在,则返回 true; 否则返回 false。
toString
public String toString()
获取 PlainBooleanArray 对象的字符串表示形式。
返回的字符串表示是 JSON 兼容的。
覆盖:
类 Object 中的 toString
返回:
返回 PlainBooleanArray 的基于 JSON 的字符串表示。