IntArray
java.lang.Object
|—ohos.utils.IntArray
public class IntArray
extends Object
int 数组的集合类。 该类封装了 IntArray 上常用的操作,供您调用。 它还支持有关通用堆栈的基本操作,因此您可以将它们用作 int 堆栈。
当 int 原始数据类型存储到泛型集合类中时,它会自动转换为相应的数据类型。 此过程称为自动装箱,但是会在一定程度上降低性能。 为了解决这个问题,这个类用于将 int 原始数据存储为一个集合类,而不需要自动装箱过程。 该类支持阵列的自动缩放,因此您无需担心阵列容量。
使用 IntArray 类时要注意以下几点: 该类是非线程安全的,不建议用于服务并发。
字段摘要
修饰符和类型 | 字段 | 描述 |
---|---|---|
static int | ERROR_INDEX | 指示索引相关操作使用的无效索引。 |
构造函数摘要
构造函数 | 描述 |
---|---|
IntArray() | 默认构造函数用于创建初始容量为 32 的 IntArray 实例。 |
IntArray(int capacity) | 用于创建具有自定义初始容量的 IntArray 实例的构造函数。 |
IntArray(int… otherArray) | 基于大小可变的 int 数组创建一个 IntArray 对象。 |
IntArray(int[] otherArray, int begin, int count) | 基于具有指定范围的现有 int 数组创建一个 IntArray 对象。 |
IntArray(int capacity, int value) | 用于创建具有自定义容量和初始值的 IntArray 实例的构造函数。 |
IntArray(ListInteger intList) | 根据现有的 Integer 列表创建一个 IntArray 对象。 |
IntArray(IntArray another) | 通过从现有 IntArray 对象复制参数来创建 IntArray 对象。 |
方法总结
修饰符和类型 | 方法 | 描述 |
---|---|---|
void | append(IntArray other) | 将指定的 IntArray 对象的值依次附加到当前的 IntArray 对象。 |
int | back() | 获取当前 IntArray 对象的数组中的最后一个值。 |
int | binarySearchInInsArray(int value) | 使用二分搜索算法搜索指定的值。 |
void | clear() | 清除存储在当前 IntArray 对象中的所有值。 |
Object | clone() | 创建当前 IntArray 对象的克隆。 |
void | deleteFirstValue(int value) | 删除与指定值匹配的第一个值。 |
void | deleteIndex(int index) | 删除指定索引处的值。 |
void | deleteRangeIn(int low, int high) | 删除指定范围内的值,包括开始索引和结束索引。 |
boolean | empty() | 检查当前 IntArray 对象是否为空。 |
boolean | equals(int[] otherArrays) | 将当前 IntArray 对象中的值与 int 数组进行比较并返回比较结果。 |
boolean | equals(Object obj) | 将当前 IntArray 对象与指定对象进行比较,并返回比较结果。 |
int | getAt(int index) | 获取指定索引处的值。 |
int | getCapacity() | 获取当前 IntArray 对象的容量。 |
int | hashCode() | 获取当前 IntArray 对象的哈希码。 |
int | indexOf(int value) | 获取当前 IntArray 对象中第一个匹配值的索引。 |
void | insert(int index, int value) | 将值插入指定索引。 |
int | lastIndexOf(int value) | 获取当前 IntArray 对象中最后一个匹配值的索引。 |
int | popBack() | 获取并删除当前 IntArray 对象的数组中的最后一个值。 |
void | pushBack(int value) | 将指定值添加到当前 IntArray 对象中的数组末尾。 |
void | setAt(int index, int value) | 更新指定索引处的值。 |
int | size() | 获取当前 IntArray 中存储的值的总数。 |
void | sortIns() | 对当前 Int Array 对象中的数组进行升序排序。 |
void | swap(IntArray other) | 在指定的 IntArray 对象和当前的 IntArray 对象之间交换元素,包括数组、大小和容量。 |
Integer[] | toIntegerArray() | 复制当前 IntArray 对象中的值并将它们转换为 Integer 数组。 |
String | toString() | 获取当前 IntArray 对象的字符串表示形式。 |
String | toString(String sep) | 获取具有指定分隔符的当前 IntArray 对象的字符串表示形式。 |
从类 java.lang.Object 继承的方法 |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
字段详细信息
ERROR_INDEX
public static final int ERROR_INDEX
指示索引相关操作使用的无效索引。
构造函数详细信息
IntArray
public IntArray()
默认构造函数用于创建初始容量为 32 的 IntArray 实例。
IntArray
public IntArray(int capacity)
用于创建具有自定义初始容量的 IntArray 实例的构造函数。
参数:
参数名称 | 参数描述 |
---|---|
capacity | 指示要为对象自定义的初始容量。 |
IntArray
public IntArray(int capacity, int value)
用于创建具有自定义容量和初始值的 IntArray 实例的构造函数。
参数:
参数名称 | 参数描述 |
---|---|
capacity | 指示要为数组自定义的初始大小。 |
value | 表示数组的初始值。 |
IntArray
public IntArray(IntArray another)
通过从现有 IntArray 对象复制参数来创建 IntArray 对象。
参数:
参数名称 | 参数描述 |
---|---|
another | 指示现有的 IntArray 对象。 |
Throws:
Throw名称 | Throw描述 |
---|---|
NullPointerException | 如果另一个为空,则抛出此异常。 |
IntArray
public IntArray(int… otherArray)
基于大小可变的 int 数组创建一个 IntArray 对象。
参数:
参数名称 | 参数描述 |
---|---|
otherArray | 指示大小可变的 int 数组。 |
IntArray
public IntArray(int[] otherArray, int begin, int count)
基于具有指定范围的现有 int 数组创建一个 IntArray 对象。
参数:
参数名称 | 参数描述 |
---|---|
otherArray | 指示现有的 int 数组。 |
begin | 指示现有数组的起始索引。 |
count | 指示存储在现有数组中的值的数量。 |
Throws:
Throw名称 | Throw描述 |
---|---|
IllegalArgumentException | 如果指定的 otherArray 为 null,则引发此异常。 |
ArrayIndexOutOfBoundsException | 如果指定的开始或计数超出范围,则引发此异常。 |
IntArray
public IntArray(ListInteger intList)
根据现有的 Integer 列表创建一个 IntArray 对象。
参数:
参数名称 | 参数描述 |
---|---|
intList | 指示现有的 Integer 列表。 |
方法详情
hashCode
public int hashCode()
获取当前 IntArray 对象的哈希码。
覆盖:
类 Object 中的 hashCode
返回:
返回当前 IntArray 对象的哈希码。
equals
public boolean equals(int[] otherArrays)
将当前 IntArray 对象中的值与 int 数组进行比较并返回比较结果。
参数:
参数名称 | 参数描述 |
---|---|
otherArrays | 指示要比较的 int 数组。 |
返回:
如果两者在序列中具有相同的值,则返回 true。
equals
public boolean equals(Object obj)
将当前 IntArray 对象与指定对象进行比较,并返回比较结果。
覆盖:
类 Object 中的等于
参数:
参数名称 | 参数描述 |
---|---|
obj | 指示要比较的指定对象。 |
返回:
如果两者在序列中具有相同的值,则返回 true。
clone
public Object clone()
创建当前 IntArray 对象的克隆。
覆盖:
在类 Object 中克隆
返回:
返回当前 IntArray 对象的克隆。
toString
public String toString()
获取当前 IntArray 对象的字符串表示形式。
转换为字符串时,值用方括号 ([]) 括起来,并用逗号 (,) 分隔,例如 [1, 2, 3, 4, 5]。
覆盖:
类 Object 中的 toString
返回:
返回当前 IntArray 对象的字符串表示形式。
toString
public String toString(String sep)
获取具有指定分隔符的当前 IntArray 对象的字符串表示形式。
转换为字符串时,这些值括在方括号 ([]) 中并由分隔符分隔。 例如,如果指定的分隔符是分号 (;),则字符串表示的格式为 [1;2;3;4;5]。
参数:
参数名称 | 参数描述 |
---|---|
sep | 指示字符串表示形式中的值的分隔符。 |
返回:
返回当前 IntArray 对象的字符串表示形式,其值使用指定的分隔符分隔。
getCapacity
public int getCapacity()
获取当前 IntArray 对象的容量。
该方法的返回值是对象的容量,而不是对象中的值所占用的实际大小。
返回:
返回当前 IntArray 对象的容量。
insert
public void insert(int index, int value)
将值插入指定索引。
如果指定的索引有值,则该索引及其后面的值向后移动一个索引。
参数:
参数名称 | 参数描述 |
---|---|
index | 索引 |
value | 值 |
getAt
public int getAt(int index)
获取指定索引处的值。
参数:
参数名称 | 参数描述 |
---|---|
index | 表示要查询的值的索引。 |
返回:
返回指定索引处的值。
Throws:
Throw名称 | Throw描述 |
---|---|
ArrayIndexOutOfBoundsException | 如果指定的索引超出有效范围,则引发此异常。 |
setAt
public void setAt(int index, int value)
更新指定索引处的值。
与 insert(int,int) 方法不同的是,如果指定的索引存在,则此方法将现有值替换为新值。
参数:
参数名称 | 参数描述 |
---|---|
index | 指示要更新的值的索引。 |
value | 表示要更新的值。 |
Throws:
Throw名称 | Throw描述 |
---|---|
ArrayIndexOutOfBoundsException | 如果指定的索引超出有效范围,则引发此异常。 |
indexOf
public int indexOf(int value)
获取当前 IntArray 对象中第一个匹配值的索引。
参数:
参数名称 | 参数描述 |
---|---|
value | 表示要查询的值。 |
返回:
返回第一个匹配值的索引; 如果值不存在,则返回 ERROR_INDEX。
lastIndexOf
public int lastIndexOf(int value)
获取当前 IntArray 对象中最后一个匹配值的索引。
参数:
参数名称 | 参数描述 |
---|---|
value | 表示要查询的值。 |
返回:
返回最后一个匹配值的索引; 如果值不存在,则返回 ERROR_INDEX。
clear
public void clear()
清除存储在当前 IntArray 对象中的所有值。
size
public int size()
获取当前 IntArray 中存储的值的总数。
返回:
返回存储在当前 IntArray 中的值的总数。
empty
public boolean empty()
检查当前 IntArray 对象是否为空。
返回:
如果当前 IntArray 对象为空,则返回 true。
pushBack
public void pushBack(int value)
将指定值添加到当前 IntArray 对象中的数组末尾。
参数:
参数名称 | 参数描述 |
---|---|
value | 表示要添加的值。 |
popBack
public int popBack()
获取并删除当前 IntArray 对象的数组中的最后一个值。 该值在返回时从数组中删除。
返回:
返回当前 IntArray 对象的数组中的最后一个值。
back
public int back()
获取当前 IntArray 对象的数组中的最后一个值。 该值在返回时不会被删除。
返回:
返回当前 IntArray 对象的数组中的最后一个值。
swap
public void swap(IntArray other)
在指定的 IntArray 对象和当前的 IntArray 对象之间交换元素,包括数组、大小和容量。
参数:
参数名称 | 参数描述 |
---|---|
other | 指示要交换的 IntArray 对象。 |
Throws:
Throw名称 | Throw描述 |
---|---|
NullPointerException | 如果另一个为空,则抛出此异常。 |
append
public void append(IntArray other)
将指定的 IntArray 对象的值依次附加到当前的 IntArray 对象。
参数:
参数名称 | 参数描述 |
---|---|
other | 指示 IntArray 对象。 |
Throws:
Throw名称 | Throw描述 |
---|---|
NullPointerException | 如果另一个为空,则抛出此异常。 |
toIntegerArray
public Integer[] toIntegerArray()
复制当前 IntArray 对象中的值并将它们转换为 Integer 数组。
返回:
返回一个整数数组,其中包含从当前 IntArray 对象复制的值。
deleteFirstValue
public void deleteFirstValue(int value)
删除与指定值匹配的第一个值。
参数:
参数名称 | 参数描述 |
---|---|
value | 指示要删除的值。 |
deleteIndex
public void deleteIndex(int index)
删除指定索引处的值。
参数:
参数名称 | 参数描述 |
---|---|
index | 指示要删除的值的索引。 |
Throws:
Throw名称 | Throw描述 |
---|---|
ArrayIndexOutOfBoundsException | 如果指定的索引超出有效范围,则引发此异常。 |
deleteRangeIn
public void deleteRangeIn(int low, int high)
删除指定范围内的值,包括开始索引和结束索引。
参数:
参数名称 | 参数描述 |
---|---|
low | 指示要删除的值的起始索引。 |
high | 指示要删除的值的结束索引。 |
Throws:
Throw名称 | Throw描述 |
---|---|
ArrayIndexOutOfBoundsException | 如果指定的索引超出有效范围,则引发此异常。 |
sortIns
public void sortIns()
对当前 Int Array 对象中的数组进行升序排序。
binarySearchInInsArray
public int binarySearchInInsArray(int value)
使用二分搜索算法搜索指定的值。 如果没有找到结果,则返回负值。 但是,您可以反转此负值以获得应将值插入当前 IntArray 对象的索引。
请注意,必须对有序数组执行二进制搜索。 因此,在调用此方法之前,必须使用 sortIns() 方法对对象中的值进行排序。 否则返回的结果是不确定的。
参数:
参数名称 | 参数描述 |
---|---|
value | 指示要搜索的值。 |
返回:
返回值的索引; 如果没有找到结果,则返回负值。