Класс AtomicIntegerArray

java.lang.Object

java.util.concurrent.atomic.AtomicIntegerArray

Все реализуемые интерфейсы:: Serializable

public class AtomicIntegerArray extends Object implements Serializable

Массив целых чисел, элементы которого могут быть обновлены атомарно. Смотрите спецификацию VarHandle для описания свойств атомарных операций доступа.

С момента:

1.5

См. также:

Краткое описание конструкторов

Конструктор	Описание
`AtomicIntegerArray(int length)`	Создаёт новый массив AtomicIntegerArray заданной длины, все элементы которого изначально равны нулю.
`AtomicIntegerArray(int[] array)`	Создаёт новый массив AtomicIntegerArray, длина которого совпадает с длиной заданного массива, а все элементы скопированы из него.

Краткое описание методов

Модификатор и тип	Метод	Описание
`final int`	`accumulateAndGet(int i, int x, IntBinaryOperator accumulatorFunction)`	Атомарно обновляет (с эффектами памяти, как указано в `VarHandle.compareAndSet(java.lang.Object...)`) элемент по индексу `i` с результатами применения данной функции к текущим и заданным значениям, возвращая обновленное значение.
`final int`	`addAndGet(int i, int delta)`	Атомарно добавляет заданное значение к элементу по индексу `i`, с эффектами памяти, как указано в `VarHandle.getAndAdd(java.lang.Object...)`.
`final int`	`compareAndExchange(int i, int expectedValue, int newValue)`	Атомарно устанавливает элемент по индексу `i` в `newValue`, если текущее значение элемента, называемое значением-свидетелем, `== expectedValue`, с эффектами памяти, как указано в `VarHandle.compareAndExchange(java.lang.Object...)`.
`final int`	`compareAndExchangeAcquire(int i, int expectedValue, int newValue)`	Атомарно устанавливает элемент по индексу `i` в `newValue`, если текущее значение элемента, называемое значением-свидетелем, `== expectedValue`, с эффектами памяти, как указано в `VarHandle.compareAndExchangeAcquire(java.lang.Object...)`.
`final int`	`compareAndExchangeRelease(int i, int expectedValue, int newValue)`	Атомарно устанавливает элемент по индексу `i` в `newValue`, если текущее значение элемента, называемое значением-свидетелем, `== expectedValue`, с эффектами памяти, как указано в `VarHandle.compareAndExchangeRelease(java.lang.Object...)`.
`final boolean`	`compareAndSet(int i, int expectedValue, int newValue)`	Атомарно устанавливает элемент по индексу `i` в `newValue`, если текущее значение элемента `== expectedValue`, с эффектами памяти, как указано в `VarHandle.compareAndSet(java.lang.Object...)`.
`final int`	`decrementAndGet(int i)`	Атомарно уменьшает значение элемента по индексу `i`, с эффектами памяти, как указано в `VarHandle.getAndAdd(java.lang.Object...)`.
`final int`	`get(int i)`	Возвращает текущее значение элемента по индексу `i`, с эффектами памяти, как указано в `VarHandle.getVolatile(java.lang.Object...)`.
`final int`	`getAcquire(int i)`	Возвращает текущее значение элемента по индексу `i`, с эффектами памяти, как указано в `VarHandle.getAcquire(java.lang.Object...)`.
`final int`	`getAndAccumulate(int i, int x, IntBinaryOperator accumulatorFunction)`	Атомарно обновляет (с эффектами памяти, как указано в `VarHandle.compareAndSet(java.lang.Object...)`) элемент по индексу `i` с результатами применения данной функции к текущим и заданным значениям, возвращая предыдущее значение.
`final int`	`getAndAdd(int i, int delta)`	Атомарно добавляет заданное значение к элементу по индексу `i`, с эффектами памяти, как указано в `VarHandle.getAndAdd(java.lang.Object...)`.
`final int`	`getAndDecrement(int i)`	Атомарно уменьшает значение элемента по индексу `i`, с эффектами памяти, как указано в `VarHandle.getAndAdd(java.lang.Object...)`.
`final int`	`getAndIncrement(int i)`	Атомарно увеличивает значение элемента по индексу `i`, с эффектами памяти, как указано в `VarHandle.getAndAdd(java.lang.Object...)`.
`final int`	`getAndSet(int i, int newValue)`	Атомарно устанавливает элемент по индексу `i` в `newValue` и возвращает старое значение, с эффектами памяти, как указано в `VarHandle.getAndSet(java.lang.Object...)`.
`final int`	`getAndUpdate(int i, IntUnaryOperator updateFunction)`	Атомарно обновляет (с эффектами памяти, как указано в `VarHandle.compareAndSet(java.lang.Object...)`) элемент по индексу `i` с результатами применения данной функции, возвращая предыдущее значение.
`final int`	`getOpaque(int i)`	Возвращает текущее значение элемента по индексу `i`, с эффектами памяти, как указано в `VarHandle.getOpaque(java.lang.Object...)`.
`final int`	`getPlain(int i)`	Возвращает текущее значение элемента по индексу `i`, с семантикой памяти чтения, как если бы переменная была объявлена как non-`volatile`.
`final int`	`incrementAndGet(int i)`	Атомарно увеличивает значение элемента по индексу `i`, с эффектами памяти, как указано в `VarHandle.getAndAdd(java.lang.Object...)`.
`final void`	`lazySet(int i, int newValue)`	Устанавливает элемент по индексу `i` в `newValue`, с эффектами памяти, как указано в `VarHandle.setRelease(java.lang.Object...)`.
`final int`	`length()`	Возвращает длину массива.
`final void`	`set(int i, int newValue)`	Устанавливает элемент по индексу `i` в `newValue`, с эффектами памяти, как указано в `VarHandle.setVolatile(java.lang.Object...)`.
`final void`	`setOpaque(int i, int newValue)`	Устанавливает элемент по индексу `i` в `newValue`, с эффектами памяти, как указано в `VarHandle.setOpaque(java.lang.Object...)`.
`final void`	`setPlain(int i, int newValue)`	Устанавливает элемент по индексу `i` в `newValue`, с семантикой памяти установки, как если бы переменная была объявлена как non-`volatile` и non-`final`.
`final void`	`setRelease(int i, int newValue)`	Устанавливает элемент по индексу `i` в `newValue`, с эффектами памяти, как указано в `VarHandle.setRelease(java.lang.Object...)`.
`String`	`toString()`	Возвращает строковое представление текущих значений массива.
`final int`	`updateAndGet(int i, IntUnaryOperator updateFunction)`	Атомарно обновляет (с эффектами памяти, как указано в `VarHandle.compareAndSet(java.lang.Object...)`) элемент по индексу `i` с результатами применения данной функции, возвращая обновленное значение.
`final boolean`	`weakCompareAndSet(int i, int expectedValue, int newValue)`	Устарело. Этот метод имеет простые эффекты памяти, но имя метода подразумевает эффекты летучей памяти (см. методы, такие как `compareAndExchange(int, int, int)` и `compareAndSet(int, int, int)`).
`final boolean`	`weakCompareAndSetAcquire(int i, int expectedValue, int newValue)`	Возможно атомарно устанавливает элемент по индексу `i` в `newValue`, если текущее значение элемента `== expectedValue`, с эффектами памяти, как указано в `VarHandle.weakCompareAndSetAcquire(java.lang.Object...)`.
`final boolean`	`weakCompareAndSetPlain(int i, int expectedValue, int newValue)`	Возможно атомарно устанавливает элемент по индексу `i` в `newValue`, если текущее значение элемента `== expectedValue`, с эффектами памяти, как указано в `VarHandle.weakCompareAndSetPlain(java.lang.Object...)`.
`final boolean`	`weakCompareAndSetRelease(int i, int expectedValue, int newValue)`	Возможно атомарно устанавливает элемент по индексу `i` в `newValue`, если текущее значение элемента `== expectedValue`, с эффектами памяти, как указано в `VarHandle.weakCompareAndSetRelease(java.lang.Object...)`.
`final boolean`	`weakCompareAndSetVolatile(int i, int expectedValue, int newValue)`	Возможно атомарно устанавливает элемент по индексу `i` в `newValue`, если текущее значение элемента `== expectedValue`, с эффектами памяти, как указано в `VarHandle.weakCompareAndSet(java.lang.Object...)`.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание конструкторов

AtomicIntegerArray

public AtomicIntegerArray(int length)

Создаёт новый массив AtomicInteger заданной длины, все элементы которого изначально равны нулю.

Параметры:: length - длина массива

AtomicIntegerArray

public AtomicIntegerArray(int[] array)

Создаёт новый массив AtomicInteger той же длины, что и заданный массив, и копирует все его элементы.

Параметры:: array - массив для копирования элементов
Исключения:: NullPointerException - если массив null

Подробное описание методов

length

public final int length()

Возвращает длину массива.

Возвращает:: длину массива

get

public final int get(int i)

Возвращает текущее значение элемента по индексу i, с эффектами памяти, указанными в VarHandle.getVolatile(java.lang.Object...).

Параметры:: i - индекс
Возвращает:: текущее значение

set

public final void set(int i, int newValue)

Устанавливает элемент по индексу i в значение newValue, с эффектами памяти, указанными в VarHandle.setVolatile(java.lang.Object...).

Параметры:: i - индекс; newValue - новое значение

lazySet

public final void lazySet(int i, int newValue)

Устанавливает элемент по индексу i в значение newValue, с эффектами памяти, указанными в VarHandle.setRelease(java.lang.Object...).

Параметры:: i - индекс; newValue - новое значение
С:: 1.6

getAndSet

public final int getAndSet(int i, int newValue)

Атомарно устанавливает элемент по индексу i в значение


 newValue

и возвращает старое значение, с эффектами памяти, указанными в VarHandle.getAndSet(java.lang.Object...).

Параметры:: i - индекс; newValue - новое значение
Возвращает:: предыдущее значение

compareAndSet

public final boolean compareAndSet(int i, int expectedValue, int newValue)

Атомарно устанавливает элемент по индексу i в значение


 newValue

, если текущее значение элемента == expectedValue, с эффектами памяти, указанными в VarHandle.compareAndSet(java.lang.Object...).

Параметры:: i - индекс; expectedValue - ожидаемое значение; newValue - новое значение
Возвращает:: true, если успешно. Возвращаемое значение false указывает, что фактическое значение не было равно ожидаемому.

weakCompareAndSet

@Deprecated(since="9") public final boolean weakCompareAndSet(int i, int expectedValue, int newValue)

Устаревшее.

Этот метод имеет обычные эффекты памяти, но имя метода подразумевает эффекты памяти volatile (см. методы, такие как compareAndExchange(int, int, int) и compareAndSet(int, int, int)). Для избежания путаницы с обычными или volatile эффектами памяти рекомендуется использовать метод weakCompareAndSetPlain(int, int, int) вместо него.

Возможно, атомарно устанавливает элемент по индексу i в значение newValue, если текущее значение элемента == expectedValue, с эффектами памяти, указанными в VarHandle.weakCompareAndSetPlain(java.lang.Object...).

Параметры:

i - индекс

expectedValue - ожидаемое значение

newValue - новое значение

Возвращает:

true, если успешно

См. также:

weakCompareAndSetPlain

public final boolean weakCompareAndSetPlain(int i, int expectedValue, int newValue)

Параметры:: i - индекс; expectedValue - ожидаемое значение; newValue - новое значение
Возвращает:: true, если успешно
С:: 9

getAndIncrement

public final int getAndIncrement(int i)

Атомарно инкрементирует значение элемента по индексу i, с эффектами памяти, указанными в VarHandle.getAndAdd(java.lang.Object...).

Эквивалентно getAndAdd(i, 1).

Параметры:: i - индекс
Возвращает:: предыдущее значение

getAndDecrement

public final int getAndDecrement(int i)

Атомарно декрементирует значение элемента по индексу i, с эффектами памяти, указанными в VarHandle.getAndAdd(java.lang.Object...).

Эквивалентно getAndAdd(i, -1).

Параметры:: i - индекс
Возвращает:: предыдущее значение

getAndAdd

public final int getAndAdd(int i, int delta)

Атомарно добавляет заданное значение к элементу по индексу i, с эффектами памяти, указанными в VarHandle.getAndAdd(java.lang.Object...).

Параметры:: i - индекс; delta - значение для добавления
Возвращает:: предыдущее значение

incrementAndGet

public final int incrementAndGet(int i)

Эквивалентно addAndGet(i, 1).

Параметры:: i - индекс
Возвращает:: обновлённое значение

decrementAndGet

public final int decrementAndGet(int i)

Эквивалентно addAndGet(i, -1).

Параметры:: i - индекс
Возвращает:: обновлённое значение

addAndGet

public final int addAndGet(int i, int delta)

Параметры:: i - индекс; delta - значение для добавления
Возвращает:: обновлённое значение

getAndUpdate

public final int getAndUpdate(int i, IntUnaryOperator updateFunction)

Атомарно обновляет (с эффектами памяти, указанными в VarHandle.compareAndSet(java.lang.Object...)) элемент по индексу i, применяя заданную функцию, возвращая предыдущее значение. Функция не должна иметь побочных эффектов, так как она может быть повторно применена, когда попытки обновления терпят неудачу из-за конкуренции между потоками.

Параметры:: i - индекс; updateFunction - функция без побочных эффектов
Возвращает:: предыдущее значение
С:: 1.8

updateAndGet

public final int updateAndGet(int i, IntUnaryOperator updateFunction)

Атомарно обновляет (с эффектами памяти, указанными в VarHandle.compareAndSet(java.lang.Object...)) элемент по индексу i, применяя заданную функцию, возвращая обновлённое значение. Функция не должна иметь побочных эффектов, так как она может быть повторно применена, когда попытки обновления терпят неудачу из-за конкуренции между потоками.

Параметры:: i - индекс; updateFunction - функция без побочных эффектов
Возвращает:: обновлённое значение
С:: 1.8

END_OF_DOCUMENT_MARKER

getAndAccumulate

public final int getAndAccumulate(int i, int x, IntBinaryOperator accumulatorFunction)

Атомарно обновляет (с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...)) элемент по индексу i результатом применения заданной функции к текущему и заданному значениям, возвращая предыдущее значение. Функция должна быть без побочных эффектов, так как она может быть повторно применена, когда попытки обновления завершаются неудачей из-за конкуренции между потоками. Функция применяется к текущему значению элемента по индексу i в качестве первого аргумента и заданному обновлению в качестве второго.

Parameters:: i - индекс; x - значение обновления; accumulatorFunction - функция без побочных эффектов от двух аргументов
Returns:: предыдущее значение
Since:: 1.8

accumulateAndGet

public final int accumulateAndGet(int i, int x, IntBinaryOperator accumulatorFunction)

Атомарно обновляет (с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...)) элемент по индексу i результатом применения заданной функции к текущему и заданному значениям, возвращая обновленное значение. Функция должна быть без побочных эффектов, так как она может быть повторно применена, когда попытки обновления завершаются неудачей из-за конкуренции между потоками. Функция применяется к текущему значению элемента по индексу i в качестве первого аргумента и заданному обновлению в качестве второго.

Parameters:: i - индекс; x - значение обновления; accumulatorFunction - функция без побочных эффектов от двух аргументов
Returns:: обновленное значение
Since:: 1.8

toString

public String toString()

Возвращает строковое представление текущих значений массива.

Overrides:: toString в классе Object
Returns:: строковое представление текущих значений массива

getPlain

public final int getPlain(int i)

Возвращает текущее значение элемента по индексу i, с семантикой памяти чтения, как если бы переменная была объявлена не-volatile.

Parameters:: i - индекс
Returns:: значение
Since:: 9

setPlain

public final void setPlain(int i, int newValue)

Устанавливает элемент по индексу i в newValue, с семантикой памяти установки, как если бы переменная была объявлена не-volatile и не-final.

Parameters:: i - индекс; newValue - новое значение
Since:: 9

getOpaque

public final int getOpaque(int i)

Возвращает текущее значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getOpaque(java.lang.Object...).

Parameters:: i - индекс
Returns:: значение
Since:: 9

setOpaque

public final void setOpaque(int i, int newValue)

Устанавливает элемент по индексу i в newValue, с эффектами памяти, как указано в VarHandle.setOpaque(java.lang.Object...).

Parameters:: i - индекс; newValue - новое значение
Since:: 9

getAcquire

public final int getAcquire(int i)

Возвращает текущее значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getAcquire(java.lang.Object...).

Parameters:: i - индекс
Returns:: значение
Since:: 9

setRelease

public final void setRelease(int i, int newValue)

Устанавливает элемент по индексу i в newValue, с эффектами памяти, как указано в VarHandle.setRelease(java.lang.Object...).

Parameters:: i - индекс; newValue - новое значение
Since:: 9

compareAndExchange

public final int compareAndExchange(int i, int expectedValue, int newValue)

Атомарно устанавливает элемент по индексу i в newValue, если текущее значение элемента, называемое значение свидетеля, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchange(java.lang.Object...).

Parameters:: i - индекс; expectedValue - ожидаемое значение; newValue - новое значение
Returns:: значение свидетеля, которое будет таким же, как ожидаемое значение, если успешно
Since:: 9

compareAndExchangeAcquire

public final int compareAndExchangeAcquire(int i, int expectedValue, int newValue)

Parameters:: i - индекс; expectedValue - ожидаемое значение; newValue - новое значение
Returns:: значение свидетеля, которое будет таким же, как ожидаемое значение, если успешно
Since:: 9

compareAndExchangeRelease

public final int compareAndExchangeRelease(int i, int expectedValue, int newValue)

Parameters:: i - индекс; expectedValue - ожидаемое значение; newValue - новое значение
Returns:: значение свидетеля, которое будет таким же, как ожидаемое значение, если успешно
Since:: 9

weakCompareAndSetVolatile

public final boolean weakCompareAndSetVolatile(int i, int expectedValue, int newValue)

Возможно атомарно устанавливает элемент по индексу i в newValue, если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSet(java.lang.Object...).

Parameters:: i - индекс; expectedValue - ожидаемое значение; newValue - новое значение
Returns:: true, если успешно
Since:: 9

weakCompareAndSetAcquire

public final boolean weakCompareAndSetAcquire(int i, int expectedValue, int newValue)

Parameters:: i - индекс; expectedValue - ожидаемое значение; newValue - новое значение
Returns:: true, если успешно
Since:: 9

weakCompareAndSetRelease

public final boolean weakCompareAndSetRelease(int i, int expectedValue, int newValue)

Parameters:: i - индекс; expectedValue - ожидаемое значение; newValue - новое значение
Returns:: true, если успешно
Since:: 9

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/concurrent/atomic/AtomicIntegerArray.html