Начиная с 27 марта 2025 г. мы рекомендуем использовать android-latest-release вместо aosp-main для создания и участия в AOSP. Дополнительные сведения см. в разделе Изменения в AOSP .

Эта страница переведена с помощью Cloud Translation API.

SparseIntArray

public class SparseIntArray
extends Object

java.lang.Object
↳	com.android.utils.SparseIntArray

SparseIntArrays сопоставляет целые числа с целыми числами. В отличие от обычного массива целых чисел, в индексах могут быть пробелы. Этот метод предназначен для более эффективного сопоставления целых чисел с целыми числами, чем использование HashMap.

Краткое содержание

Публичные конструкторы
`SparseIntArray ()` Создает новый SparseIntArray, не содержащий сопоставлений.
`SparseIntArray (int initialCapacity)` Создает новый SparseIntArray, не содержащий сопоставлений, который не потребует дополнительного выделения памяти для хранения указанного количества сопоставлений.

Публичные методы
`void`	`append (int key, int value)` Помещает пару ключ/значение в массив, оптимизируя случай, когда ключ больше всех существующих ключей в массиве.
`void`	`clear ()` Удаляет все сопоставления ключ-значение из этого SparseIntArray.
`void`	`delete (int key)` Удаляет сопоставление с указанным ключом, если таковое имелось.
`int`	`get (int key)` Возвращает int, сопоставленный с указанным ключом, или `0` если такое сопоставление не было выполнено.
`int`	`get (int key, int valueIfKeyNotFound)` Возвращает int, сопоставленный с указанным ключом, или указанное значение, если такое сопоставление не было сделано.
`int`	`indexOfKey (int key)` Возвращает индекс, для которого `keyAt(int)` вернет указанный ключ, или отрицательное число, если указанный ключ не сопоставлен.
`int`	`indexOfValue (int value)` Возвращает индекс, для которого `valueAt(int)` вернет указанный ключ или отрицательное число, если ни один ключ не соответствует указанному значению.
`int`	`keyAt (int index)` При наличии индекса в диапазоне `0...size()-1` возвращает ключ из `index` -го сопоставления ключ-значение, которое хранит этот SparseIntArray.
`void`	`put (int key, int value)` Добавляет сопоставление указанного ключа с указанным значением, заменяя предыдущее сопоставление указанного ключа, если таковое имелось.
`void`	`removeAt (int index)` Удаляет сопоставление по указанному индексу.
`int`	`size ()` Возвращает количество сопоставлений «ключ-значение», которые в данный момент хранит этот SparseIntArray.
`int`	`valueAt (int index)` При наличии индекса в диапазоне `0...size()-1` возвращает значение из `index` -го сопоставления ключ-значение, которое хранит этот SparseIntArray.

Публичные конструкторы

SparseIntArray

public SparseIntArray ()

Создает новый SparseIntArray, не содержащий сопоставлений.

SparseIntArray

public SparseIntArray (int initialCapacity)

Создает новый SparseIntArray, не содержащий сопоставлений, который не потребует дополнительного выделения памяти для хранения указанного количества сопоставлений.

Параметры
`initialCapacity`	`int`

Публичные методы

добавить

public void append (int key, 
                int value)

Помещает пару ключ/значение в массив, оптимизируя случай, когда ключ больше всех существующих ключей в массиве.

Параметры
`key`	`int`
`value`	`int`

прозрачный

public void clear ()

Удаляет все сопоставления ключ-значение из этого SparseIntArray.

удалить

public void delete (int key)

Удаляет сопоставление с указанным ключом, если таковое имелось.

Параметры
`key`	`int`

получать

public int get (int key)

Возвращает int, сопоставленный с указанным ключом, или 0 если такое сопоставление не было выполнено.

Параметры
`key`	`int`

Возврат
`int`

получать

public int get (int key, 
                int valueIfKeyNotFound)

Возвращает int, сопоставленный с указанным ключом, или указанное значение, если такое сопоставление не было сделано.

Параметры
`key`	`int`
`valueIfKeyNotFound`	`int`

Возврат
`int`

indexOfKey

public int indexOfKey (int key)

Возвращает индекс, для которого keyAt(int) вернет указанный ключ, или отрицательное число, если указанный ключ не сопоставлен.

Параметры
`key`	`int`

Возврат
`int`

indexOfValue

public int indexOfValue (int value)

Возвращает индекс, для которого valueAt(int) вернёт указанный ключ или отрицательное число, если ни один ключ не соответствует указанному значению. Обратите внимание, что это линейный поиск, в отличие от поиска по ключу, и что несколько ключей могут соответствовать одному и тому же значению, и будет найден только один из них.

Параметры
`value`	`int`

Возврат
`int`

keyAt

public int keyAt (int index)

При наличии индекса в диапазоне 0...size()-1 возвращает ключ из index -го сопоставления ключ-значение, которое хранит этот SparseIntArray.

Параметры
`index`	`int`

Возврат
`int`

помещать

public void put (int key, 
                int value)

Добавляет сопоставление указанного ключа с указанным значением, заменяя предыдущее сопоставление указанного ключа, если таковое имелось.

Параметры
`key`	`int`
`value`	`int`

удалитьВ

public void removeAt (int index)

Удаляет сопоставление по указанному индексу.

Параметры
`index`	`int`

размер

public int size ()

Возвращает количество сопоставлений «ключ-значение», которые в данный момент хранит этот SparseIntArray.

Возврат
`int`

значениеAt

public int valueAt (int index)

При наличии индекса в диапазоне 0...size()-1 возвращает значение из index -го сопоставления ключ-значение, которое хранит этот SparseIntArray.

Параметры
`index`	`int`

Возврат
`int`