IntArray

java.lang.Object
- ohos.utils.IntArray

```
public class IntArray
extends Object
```
A collection class of int arrays. This class encapsulates commonly used operations on IntArray for you to invoke. It also supports basic operations regarding generic stacks, so that you can use them as int stacks.
When the int primitive data type is stored into a generic collection class, it is automatically converted into a corresponding data type. This process is known as autoboxing, which however, will deteriorate performance to some extent. To resolve this issue, this class is used to store the int primitive data as a collection class, without the autoboxing process. This class supports automatic scaling of arrays so that you do not need to worry about the array capacity.
Pay attention to the following when using the IntArray class: This class is non-thread safe and is not recommended for service concurrency.

从以下版本开始:

1

字段概要

字段
限定符和类型字段说明

static int ERROR_INDEX
Indicates an invalid index used by index-related operations.

字段
限定符和类型	字段	说明
`static int`	`ERROR_INDEX`	Indicates an invalid index used by index-related operations.

构造器概要

构造器
构造器	说明
`IntArray()`	Default constructor used to create an `IntArray` instance with an initial capacity of 32.
`IntArray(int capacity)`	A constructor used to create an `IntArray` instance with a custom initial capacity.
`IntArray(int... otherArray)`	Creates an `IntArray` object based on a size-mutable `int` array.
`IntArray(int[] otherArray, int begin, int count)`	Creates an `IntArray` object based on an existing `int` array with a specified range.
`IntArray(int capacity, int value)`	A constructor used to create an `IntArray` instance with a custom capacity and an initial value.
`IntArray(List<Integer> intList)`	Creates an `IntArray` object based on an existing `Integer` list.
`IntArray(IntArray another)`	Creates an `IntArray` object by copying parameters from an existing `IntArray` object.

方法概要

所有方法实例方法具体方法
限定符和类型	方法	说明
`void`	`append(IntArray other)`	Appends the values of a specified `IntArray` object to the current `IntArray` object in sequence.
`int`	`back()`	Obtains the last value in the array of the current `IntArray` object.
`int`	`binarySearchInInsArray(int value)`	Searches for a specified value using the binary search algorithm.
`void`	`clear()`	Clears all values stored in the current `IntArray` object.
`Object`	`clone()`	Creates a clone of the current `IntArray` object.
`void`	`deleteFirstValue(int value)`	Deletes the first value matched with the specified value.
`void`	`deleteIndex(int index)`	Deletes the value at a specified index.
`void`	`deleteRangeIn(int low, int high)`	Deletes values in a specified range with both the start and end indexes included.
`boolean`	`empty()`	Checks whether the current `IntArray` object is empty.
`boolean`	`equals(int[] otherArrays)`	Compares values in the current `IntArray` object with an `int` array and returns the comparison result.
`boolean`	`equals(Object obj)`	Compares the current `IntArray` object with the specified object and returns the comparison result.
`int`	`getAt(int index)`	Obtains the value at a specified index.
`int`	`getCapacity()`	Obtains the capacity of the current `IntArray` object.
`int`	`hashCode()`	Obtains the hash code of the current `IntArray` object.
`int`	`indexOf(int value)`	Obtains the index of the first matched value in the current `IntArray` object.
`void`	`insert(int index, int value)`	Inserts a value to a specified index.
`int`	`lastIndexOf(int value)`	Obtains the index of the last matched value in the current `IntArray` object.
`int`	`popBack()`	Obtains and deletes the last value in the array of the current `IntArray` object.
`void`	`pushBack(int value)`	Adds a specified value to the end of the array in the current `IntArray` object.
`void`	`setAt(int index, int value)`	Updates the value at a specified index.
`int`	`size()`	Obtains the total number of values stored in the current `IntArray`.
`void`	`sortIns()`	Sorts the arrays in the current `IntArray` object in ascending order.
`void`	`swap(IntArray other)`	Exchanges elements between a specified `IntArray` object and the current `IntArray` object, including the array, size, and capacity.
`Integer[]`	`toIntegerArray()`	Copies the values in the current `IntArray` object and converts them into an `Integer` array.
`String`	`toString()`	Obtains a string representation of the current `IntArray` object.
`String`	`toString(String sep)`	Obtains a string representation of the current `IntArray` object with a specified separator.

从类继承的方法 java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait

- 字段详细资料
  - ERROR_INDEX
```
public static final int ERROR_INDEX
```
    Indicates an invalid index used by index-related operations.
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - IntArray
```
public IntArray()
```
    Default constructor used to create an IntArray instance with an initial capacity of 32.
  - IntArray
```
public IntArray(int capacity)
```
    A constructor used to create an IntArray instance with a custom initial capacity.
    
    参数:
    
    capacity - Indicates the initial capacity to customize for the object.
  - IntArray
```
public IntArray(int capacity,
                int value)
```
    A constructor used to create an IntArray instance with a custom capacity and an initial value.
    
    参数:
    
    capacity - Indicates the initial size to customize for the array.
    
    value - Indicates the initial value of the array.
  - IntArray
```
public IntArray(IntArray another)
```
    Creates an IntArray object by copying parameters from an existing IntArray object.
    
    参数:
    
    another - Indicates the existing IntArray object.
    
    抛出:
    
    NullPointerException - Throws this exception if another is null.
  - IntArray
```
public IntArray(int... otherArray)
```
    Creates an IntArray object based on a size-mutable int array.
    
    参数:
    
    otherArray - Indicates the size-mutable int array.
  - IntArray
```
public IntArray(int[] otherArray,
                int begin,
                int count)
```
    Creates an IntArray object based on an existing int array with a specified range.
    
    参数:
    
    otherArray - Indicates the existing int array.
    
    begin - Indicates the start index of the existing array.
    
    count - Indicates the number of values stored in the existing array.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if the specified otherArray is null.
    
    ArrayIndexOutOfBoundsException - Throws this exception if the specified begin or count is out of bound.
  - IntArray
```
public IntArray(List<Integer> intList)
```
    Creates an IntArray object based on an existing Integer list.
    
    参数:
    
    intList - Indicates the existing Integer list.
- 方法详细资料
  - hashCode
```
public int hashCode()
```
    Obtains the hash code of the current IntArray object.
    
    覆盖:
    
    hashCode 在类中 Object
    
    返回:
    
    Returns the hash code of the current IntArray object.
    
    另请参阅:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - equals
```
public boolean equals(int[] otherArrays)
```
    Compares values in the current IntArray object with an int array and returns the comparison result.
    
    参数:
    
    otherArrays - Indicates the int array to compare.
    
    返回:
    
    Returns true if the two have the same values in sequence.
  - equals
```
public boolean equals(Object obj)
```
    Compares the current IntArray object with the specified object and returns the comparison result.
    
    覆盖:
    
    equals 在类中 Object
    
    参数:
    
    obj - Indicates the specified object to compare.
    
    返回:
    
    Returns true if the two have the same values in sequence.
    
    另请参阅:
    
    Object.hashCode(), HashMap
  - clone
```
public Object clone()
```
    Creates a clone of the current IntArray object.
    
    覆盖:
    
    clone 在类中 Object
    
    返回:
    
    Returns the clone of the current IntArray object.
    
    另请参阅:
    
    Cloneable
  - toString
```
public String toString()
```
    Obtains a string representation of the current IntArray object.
    When being converted into a string, the values are enclosed in square brackets ([]) and separated by commas (,), for example, [1, 2, 3, 4, 5].
    
    覆盖:
    
    toString 在类中 Object
    
    返回:
    
    Returns the string representation of the current IntArray object.
  - toString
```
public String toString(String sep)
```
    Obtains a string representation of the current IntArray object with a specified separator.
    When being converted into a string, the values are enclosed in square brackets ([]) and separated by the separator. For example, if the specified separator is a semicolon (;), the string representation is in the format of [1;2;3;4;5].
    
    参数:
    
    sep - Indicates the separator for the values in the string representation.
    
    返回:
    
    Returns the string representation of the current IntArray object, with values separated using the specified separator.
  - getCapacity
```
public int getCapacity()
```
    Obtains the capacity of the current IntArray object.
    The return value of this method is the capacity of the object, but not the actual size occupied by the values in this object.
    
    返回:
    
    Returns the capacity of the current IntArray object.
  - insert
```
public void insert(int index,
                   int value)
```
    Inserts a value to a specified index.
    If the specified index has a value, this index and its followed values are moved backward by one index.
    
    参数:
    
    index - The index.
    
    value - A value.
  - getAt
```
public int getAt(int index)
```
    Obtains the value at a specified index.
    
    参数:
    
    index - Indicates the index of the value to query.
    
    返回:
    
    Returns the value at the specified index.
    
    抛出:
    
    ArrayIndexOutOfBoundsException - Throws this exception if the specified index is beyond the valid range.
  - setAt
```
public void setAt(int index,
                  int value)
```
    Updates the value at a specified index.
    Different from the insert(int,int) method, this method replaces the existing value with the new one if the specified index exists.
    
    参数:
    
    index - Indicates the index of the value to update.
    
    value - Indicates the value to be updated.
    
    抛出:
    
    ArrayIndexOutOfBoundsException - Throws this exception if the specified index is beyond the valid range.
  - indexOf
```
public int indexOf(int value)
```
    Obtains the index of the first matched value in the current IntArray object.
    
    参数:
    
    value - Indicates the value to query.
    
    返回:
    
    Returns the index of the first matched value; returns ERROR_INDEX if the value does not exist.
  - lastIndexOf
```
public int lastIndexOf(int value)
```
    Obtains the index of the last matched value in the current IntArray object.
    
    参数:
    
    value - Indicates the value to query.
    
    返回:
    
    Returns the index of the last matched value; returns ERROR_INDEX if the value does not exist.
  - clear
```
public void clear()
```
    Clears all values stored in the current IntArray object.
  - size
```
public int size()
```
    Obtains the total number of values stored in the current IntArray.
    
    返回:
    
    Returns the total number of values stored in the current IntArray.
  - empty
```
public boolean empty()
```
    Checks whether the current IntArray object is empty.
    
    返回:
    
    Returns true if the current IntArray object is empty.
  - pushBack
```
public void pushBack(int value)
```
    Adds a specified value to the end of the array in the current IntArray object.
    
    参数:
    
    value - Indicates the value to add.
  - popBack
```
public int popBack()
```
    Obtains and deletes the last value in the array of the current IntArray object. This value is deleted from the array when it is returned.
    
    返回:
    
    Returns the last value in the array of the current IntArray object.
  - back
```
public int back()
```
    Obtains the last value in the array of the current IntArray object. This value will not be deleted when it is returned.
    
    返回:
    
    Returns the last value in the array of the current IntArray object.
  - swap
```
public void swap(IntArray other)
```
    Exchanges elements between a specified IntArray object and the current IntArray object, including the array, size, and capacity.
    
    参数:
    
    other - Indicates the IntArray object to be exchanged.
    
    抛出:
    
    NullPointerException - Throws this exception if another is null.
  - append
```
public void append(IntArray other)
```
    Appends the values of a specified IntArray object to the current IntArray object in sequence.
    
    参数:
    
    other - Indicates the IntArray object.
    
    抛出:
    
    NullPointerException - Throws this exception if another is null.
  - toIntegerArray
```
public Integer[] toIntegerArray()
```
    Copies the values in the current IntArray object and converts them into an Integer array.
    
    返回:
    
    Returns an Integer array that contains the values copied from the current IntArray object.
  - deleteFirstValue
```
public void deleteFirstValue(int value)
```
    Deletes the first value matched with the specified value.
    
    参数:
    
    value - Indicates the value to delete.
  - deleteIndex
```
public void deleteIndex(int index)
```
    Deletes the value at a specified index.
    
    参数:
    
    index - Indicates the index of the value to delete.
    
    抛出:
    
    ArrayIndexOutOfBoundsException - Throws this exception if the specified index is beyond the valid range.
  - deleteRangeIn
```
public void deleteRangeIn(int low,
                          int high)
```
    Deletes values in a specified range with both the start and end indexes included.
    
    参数:
    
    low - Indicates the start index of the values to delete.
    
    high - Indicates the end index of the values to delete.
    
    抛出:
    
    ArrayIndexOutOfBoundsException - Throws this exception if the specified index is beyond the valid range.
  - sortIns
```
public void sortIns()
```
    Sorts the arrays in the current IntArray object in ascending order.
  - binarySearchInInsArray
```
public int binarySearchInInsArray(int value)
```
    Searches for a specified value using the binary search algorithm. If no result is found, a negative value is returned. However, you can invert this negative value to obtain the index where the value should be inserted into the current IntArray object.
    Note that the binary search must be performed on ordered arrays. Therefore, before calling this method, you must use the sortIns() method to sort values in the object. Otherwise, the returned result is uncertain.
    
    参数:
    
    value - Indicates the value to search for.
    
    返回:
    
    Returns the index of the value; returns a negative value if no result is found.

类 IntArray

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

ERROR_INDEX

构造器详细资料

IntArray

IntArray

IntArray

IntArray

IntArray

IntArray

IntArray

方法详细资料

hashCode

equals

equals

clone

toString

toString

getCapacity

insert

getAt

setAt

indexOf

lastIndexOf

clear

size

empty

pushBack

popBack

back

swap

append

toIntegerArray

deleteFirstValue

deleteIndex

deleteRangeIn

sortIns

binarySearchInInsArray