鸿蒙OS开发文档 鸿蒙OS IntArray

2024-02-25 开发教程 鸿蒙OS开发文档 匿名 2

IntArray

java.lang.Object
|---ohos.utils.IntArray

public class IntArray
extends Object

int 数组的集合类。 该类封装了 IntArray 上常用的操作,供您调用。 它还支持有关通用堆栈的基本操作,因此您可以将它们用作 int 堆栈。

当 int 原始数据类型存储到泛型集合类中时,它会自动转换为相应的数据类型。 此过程称为自动装箱,但是会在一定程度上降低性能。 为了解决这个问题,这个类用于将 int 原始数据存储为一个集合类,而不需要自动装箱过程。 该类支持阵列的自动缩放,因此您无需担心阵列容量。

使用 IntArray 类时要注意以下几点: 该类是非线程安全的,不建议用于服务并发。

字段摘要

修饰符和类型字段描述
static intERROR_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 对象。

方法总结

修饰符和类型方法描述
voidappend(IntArray other)将指定的 IntArray 对象的值依次附加到当前的 IntArray 对象。
intback()获取当前 IntArray 对象的数组中的最后一个值。
intbinarySearchInInsArray(int value)使用二分搜索算法搜索指定的值。
voidclear()清除存储在当前 IntArray 对象中的所有值。
Objectclone()创建当前 IntArray 对象的克隆。
voiddeleteFirstValue(int value)删除与指定值匹配的第一个值。
voiddeleteIndex(int index)删除指定索引处的值。
voiddeleteRangeIn(int low, int high)删除指定范围内的值,包括开始索引和结束索引。
booleanempty()检查当前 IntArray 对象是否为空。
booleanequals(int[] otherArrays)将当前 IntArray 对象中的值与 int 数组进行比较并返回比较结果。
booleanequals(Object obj)将当前 IntArray 对象与指定对象进行比较,并返回比较结果。
intgetAt(int index)获取指定索引处的值。
intgetCapacity()获取当前 IntArray 对象的容量。
inthashCode()获取当前 IntArray 对象的哈希码。
intindexOf(int value)获取当前 IntArray 对象中第一个匹配值的索引。
voidinsert(int index, int value)将值插入指定索引。
intlastIndexOf(int value)获取当前 IntArray 对象中最后一个匹配值的索引。
intpopBack()获取并删除当前 IntArray 对象的数组中的最后一个值。
voidpushBack(int value)将指定值添加到当前 IntArray 对象中的数组末尾。
voidsetAt(int index, int value)更新指定索引处的值。
intsize()获取当前 IntArray 中存储的值的总数。
voidsortIns()对当前 Int Array 对象中的数组进行升序排序。
voidswap(IntArray other)在指定的 IntArray 对象和当前的 IntArray 对象之间交换元素,包括数组、大小和容量。
Integer[]toIntegerArray()复制当前 IntArray 对象中的值并将它们转换为 Integer 数组。
StringtoString()获取当前 IntArray 对象的字符串表示形式。
StringtoString(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指示要搜索的值。

返回:

返回值的索引; 如果没有找到结果,则返回负值。