Класс AtomicIntegerArray

java.lang.Object
- java.util.concurrent.atomic.AtomicIntegerArray

Все реализованные интерфейсы:: Serializable

public class AtomicIntegerArray
extends Object
implements Serializable

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

С момента:: 1.5
См. также:: Сериализованная форма

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

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

Методы

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

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

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

AtomicIntegerArray

public AtomicIntegerArray(int[] array)

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

Параметры:: 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(int, int, int)

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)

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

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

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

addAndGet

public final int addAndGet(int i,
                           int delta)

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

getAndUpdate

public final int getAndUpdate(int i,
                              IntUnaryOperator updateFunction)

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

updateAndGet

public final int updateAndGet(int i,
                              IntUnaryOperator updateFunction)

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

getAndAccumulate

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

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

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

accumulateAndGet

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

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

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

toString

public String toString()

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

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

getPlain

public final int getPlain(int i)

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

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

setPlain

public final void setPlain(int i,
                           int newValue)

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

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

getOpaque

public final int getOpaque(int i)

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

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

setOpaque

public final void setOpaque(int i,
                            int newValue)

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

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

getAcquire

public final int getAcquire(int i)

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

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

setRelease

public final void setRelease(int i,
                             int newValue)

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

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

compareAndExchange

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

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

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

compareAndExchangeAcquire

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

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

compareAndExchangeRelease

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

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

weakCompareAndSetVolatile

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

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

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

weakCompareAndSetAcquire

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

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

weakCompareAndSetRelease

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

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

© 1993, 2020, 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://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/atomic/AtomicIntegerArray.html