Класс AtomicIntegerArray
java.lang.Object
java.util.concurrent.atomic.AtomicIntegerArray
- Все реализуемые интерфейсы:
Serializable
public class AtomicIntegerArray extends Object implements Serializable
Массив
int, элементы которого могут обновляться атомарно. Описание свойств атомарных операций доступа см. в спецификации VarHandle.- Начиная с:
- 1.5
- См. также:
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
AtomicIntegerArray |
Создает новый AtomicIntegerArray заданной длины, изначально заполняя все элементы нулями. |
AtomicIntegerArray |
Создает новый AtomicIntegerArray той же длины и копирует в него все элементы заданного массива. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
final int |
accumulateAndGet |
Атомарно обновляет элемент с индексом i (с эффектами памяти, указанными в VarHandle.compareAndSet(Object...)), применяя заданную функцию к текущему и заданному значениям, и возвращает обновленное значение. |
final int |
addAndGet |
Атомарно прибавляет заданное значение к элементу с индексом i с эффектами памяти, указанными в VarHandle.getAndAdd(Object...). |
final int |
compareAndExchange |
Атомарно устанавливает для элемента с индексом i значение newValue, если текущее значение элемента, называемое значением-свидетелем, == expectedValue, с эффектами памяти, указанными в VarHandle.compareAndExchange(Object...). |
final int |
compareAndExchangeAcquire |
Атомарно устанавливает для элемента с индексом i значение newValue, если текущее значение элемента, называемое значением-свидетелем, == expectedValue, с эффектами памяти, указанными в VarHandle.compareAndExchangeAcquire(Object...). |
final int |
compareAndExchangeRelease |
Атомарно устанавливает для элемента с индексом i значение newValue, если текущее значение элемента, называемое значением-свидетелем, == expectedValue, с эффектами памяти, указанными в VarHandle.compareAndExchangeRelease(Object...). |
final boolean |
compareAndSet |
Атомарно устанавливает для элемента с индексом i значение
newValue, если текущее значение элемента == expectedValue, с эффектами памяти, указанными в VarHandle.compareAndSet(Object...). |
final int |
decrementAndGet |
Атомарно уменьшает значение элемента с индексом i с эффектами памяти, указанными в VarHandle.getAndAdd(Object...). |
final int |
get |
Возвращает текущее значение элемента с индексом i с эффектами памяти, указанными в VarHandle.getVolatile(Object...). |
final int |
getAcquire |
Возвращает текущее значение элемента с индексом i с эффектами памяти, указанными в VarHandle.getAcquire(Object...). |
final int |
getAndAccumulate |
Атомарно обновляет элемент с индексом i (с эффектами памяти, указанными в VarHandle.compareAndSet(Object...)), применяя заданную функцию к текущему и заданному значениям, и возвращает предыдущее значение. |
final int |
getAndAdd |
Атомарно прибавляет заданное значение к элементу с индексом i с эффектами памяти, указанными в VarHandle.getAndAdd(Object...). |
final int |
getAndDecrement |
Атомарно уменьшает значение элемента с индексом i с эффектами памяти, указанными в VarHandle.getAndAdd(Object...). |
final int |
getAndIncrement |
Атомарно увеличивает значение элемента с индексом i с эффектами памяти, указанными в VarHandle.getAndAdd(Object...). |
final int |
getAndSet |
Атомарно устанавливает для элемента с индексом i значение
newValue и возвращает прежнее значение с эффектами памяти, указанными в VarHandle.getAndSet(Object...). |
final int |
getAndUpdate |
Атомарно обновляет элемент с индексом i (с эффектами памяти, указанными в VarHandle.compareAndSet(Object...)), применяя заданную функцию, и возвращает предыдущее значение. |
final int |
getOpaque |
Возвращает текущее значение элемента с индексом i с эффектами памяти, указанными в VarHandle.getOpaque(Object...). |
final int |
getPlain |
Возвращает текущее значение элемента с индексом i с семантикой памяти чтения, как если бы переменная была объявлена не-volatile. |
final int |
incrementAndGet |
Атомарно увеличивает значение элемента с индексом i с эффектами памяти, указанными в VarHandle.getAndAdd(Object...). |
final void |
lazySet |
Устанавливает для элемента с индексом i значение newValue с эффектами памяти, указанными в VarHandle.setRelease(Object...). |
final int |
length() |
Возвращает длину массива. |
final void |
set |
Устанавливает для элемента с индексом i значение newValue с эффектами памяти, указанными в VarHandle.setVolatile(Object...). |
final void |
setOpaque |
Устанавливает для элемента с индексом i значение newValue с эффектами памяти, указанными в VarHandle.setOpaque(Object...). |
final void |
setPlain |
Устанавливает для элемента с индексом i значение newValue с семантикой памяти записи, как если бы переменная была объявлена не-volatile и не-final. |
final void |
setRelease |
Устанавливает для элемента с индексом i значение newValue с эффектами памяти, указанными в VarHandle.setRelease(Object...). |
String |
toString() |
Возвращает строковое представление текущих значений массива. |
final int |
updateAndGet |
Атомарно обновляет элемент с индексом i (с эффектами памяти, указанными в VarHandle.compareAndSet(Object...)), применяя заданную функцию, и возвращает обновленное значение. |
final boolean |
weakCompareAndSet |
Устарел. |
final boolean |
weakCompareAndSetAcquire |
Может атомарно установить для элемента с индексом i значение newValue, если текущее значение элемента == expectedValue, с эффектами памяти, указанными в VarHandle.weakCompareAndSetAcquire(Object...). |
final boolean |
weakCompareAndSetPlain |
Может атомарно установить для элемента с индексом i значение newValue, если текущее значение элемента == expectedValue, с эффектами памяти, указанными в VarHandle.weakCompareAndSetPlain(Object...). |
final boolean |
weakCompareAndSetRelease |
Может атомарно установить для элемента с индексом i значение newValue, если текущее значение элемента == expectedValue, с эффектами памяти, указанными в VarHandle.weakCompareAndSetRelease(Object...). |
final boolean |
weakCompareAndSetVolatile |
Может атомарно установить для элемента с индексом i значение newValue, если текущее значение элемента == expectedValue, с эффектами памяти, указанными в VarHandle.weakCompareAndSet(Object...). |
Подробное описание конструкторов
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(Object...).- Параметры:
-
i— индекс - Возвращает:
- текущее значение
set
public final void set(int i, int newValue)
Устанавливает для элемента с индексом
i значение newValue; эффекты памяти определяются согласно VarHandle.setVolatile(Object...).- Параметры:
-
i— индекс -
newValue— новое значение
lazySet
public final void lazySet(int i, int newValue)
Устанавливает для элемента с индексом
i значение newValue; эффекты памяти определяются согласно VarHandle.setRelease(Object...).- Параметры:
-
i— индекс -
newValue— новое значение - Начиная с версии:
- 1.6
getAndSet
public final int getAndSet(int i, int newValue)
Атомарно устанавливает для элемента с индексом
i значение
newValue и возвращает его прежнее значение; эффекты памяти определяются согласно VarHandle.getAndSet(Object...).- Параметры:
-
i— индекс -
newValue— новое значение - Возвращает:
- предыдущее значение
compareAndSet
public final boolean compareAndSet(int i, int expectedValue, int newValue)
Атомарно устанавливает для элемента с индексом
i значение
newValue, если текущее значение элемента == expectedValue; эффекты памяти определяются согласно VarHandle.compareAndSet(Object...).- Параметры:
-
i— индекс -
expectedValue— ожидаемое значение -
newValue— новое значение - Возвращает:
-
true, если операция выполнена успешно. Возврат false означает, что фактическое значение не совпало с ожидаемым.
weakCompareAndSet
@Deprecated(since="9") public final boolean weakCompareAndSet(int i, int expectedValue, int newValue)
Устарело.
Этот метод имеет обычные эффекты памяти, однако его имя подразумевает волатильные эффекты памяти (см. такие методы, как
compareAndExchange(int, int, int) и compareAndSet(int, int, int)). Чтобы избежать неоднозначности относительно обычных и волатильных эффектов памяти, рекомендуется вместо него использовать метод weakCompareAndSetPlain(int, int, int).Возможно, атомарно устанавливает для элемента с индексом
i значение newValue, если текущее значение элемента == expectedValue; эффекты памяти определяются согласно VarHandle.weakCompareAndSetPlain(Object...).- Параметры:
-
i— индекс -
expectedValue— ожидаемое значение -
newValue— новое значение - Возвращает:
-
true, если операция выполнена успешно - См. также:
weakCompareAndSetPlain
public final boolean weakCompareAndSetPlain(int i, int expectedValue, int newValue)
Возможно, атомарно устанавливает для элемента с индексом
i значение newValue, если текущее значение элемента == expectedValue; эффекты памяти определяются согласно VarHandle.weakCompareAndSetPlain(Object...).- Параметры:
-
i— индекс -
expectedValue— ожидаемое значение -
newValue— новое значение - Возвращает:
-
true, если операция выполнена успешно - Начиная с версии:
- 9
getAndIncrement
public final int getAndIncrement(int i)
Атомарно увеличивает значение элемента с индексом
i; эффекты памяти определяются согласно VarHandle.getAndAdd(Object...). Эквивалентно getAndAdd(i, 1).
- Параметры:
-
i— индекс - Возвращает:
- предыдущее значение
getAndDecrement
public final int getAndDecrement(int i)
Атомарно уменьшает значение элемента с индексом
i; эффекты памяти определяются согласно VarHandle.getAndAdd(Object...). Эквивалентно getAndAdd(i, -1).
- Параметры:
-
i— индекс - Возвращает:
- предыдущее значение
getAndAdd
public final int getAndAdd(int i, int delta)
Атомарно прибавляет указанное значение к элементу с индексом
i; эффекты памяти определяются согласно VarHandle.getAndAdd(Object...).- Параметры:
-
i— индекс -
delta— прибавляемое значение - Возвращает:
- предыдущее значение
incrementAndGet
public final int incrementAndGet(int i)
Атомарно увеличивает значение элемента с индексом
i; эффекты памяти определяются согласно VarHandle.getAndAdd(Object...). Эквивалентно addAndGet(i, 1).
- Параметры:
-
i— индекс - Возвращает:
- обновленное значение
decrementAndGet
public final int decrementAndGet(int i)
Атомарно уменьшает значение элемента с индексом
i; эффекты памяти определяются согласно VarHandle.getAndAdd(Object...). Эквивалентно addAndGet(i, -1).
- Параметры:
-
i— индекс - Возвращает:
- обновленное значение
addAndGet
public final int addAndGet(int i, int delta)
Атомарно прибавляет указанное значение к элементу с индексом
i; эффекты памяти определяются согласно VarHandle.getAndAdd(Object...).- Параметры:
-
i— индекс -
delta— прибавляемое значение - Возвращает:
- обновленное значение
getAndUpdate
public final int getAndUpdate(int i, IntUnaryOperator updateFunction)
Атомарно обновляет (эффекты памяти определяются согласно
VarHandle.compareAndSet(Object...)) элемент с индексом i, применяя заданную функцию, и возвращает предыдущее значение. Функция должна быть без побочных эффектов, поскольку она может применяться повторно, если попытки обновления завершаются неудачей из-за конкуренции между потоками.- Параметры:
-
i— индекс -
updateFunction— функция без побочных эффектов - Возвращает:
- предыдущее значение
- Начиная с версии:
- 1.8
updateAndGet
public final int updateAndGet(int i, IntUnaryOperator updateFunction)
Атомарно обновляет (эффекты памяти определяются согласно
VarHandle.compareAndSet(Object...)) элемент с индексом i, применяя заданную функцию, и возвращает обновленное значение. Функция должна быть без побочных эффектов, поскольку она может применяться повторно, если попытки обновления завершаются неудачей из-за конкуренции между потоками.- Параметры:
-
i— индекс -
updateFunction— функция без побочных эффектов - Возвращает:
- обновленное значение
- Начиная с версии:
- 1.8
getAndAccumulate
public final int getAndAccumulate(int i, int x, IntBinaryOperator accumulatorFunction)
Атомарно обновляет (эффекты памяти определяются согласно
VarHandle.compareAndSet(Object...)) элемент с индексом i, применяя заданную функцию к текущему и указанному значениям, и возвращает предыдущее значение. Функция должна быть без побочных эффектов, поскольку она может применяться повторно, если попытки обновления завершаются неудачей из-за конкуренции между потоками. Функция получает текущего значение элемента с индексом i в качестве первого аргумента, а указанное обновление — в качестве второго аргумента.- Параметры:
-
i— индекс -
x— значение для обновления -
accumulatorFunction— функция двух аргументов без побочных эффектов - Возвращает:
- предыдущее значение
- Начиная с версии:
- 1.8
accumulateAndGet
public final int accumulateAndGet(int i, int x, IntBinaryOperator accumulatorFunction)
Атомарно обновляет (эффекты памяти определяются согласно
VarHandle.compareAndSet(Object...)) элемент с индексом i, применяя заданную функцию к текущему и указанному значениям, и возвращает обновленное значение. Функция должна быть без побочных эффектов, поскольку она может применяться повторно, если попытки обновления завершаются неудачей из-за конкуренции между потоками. Функция получает текущее значение элемента с индексом i в качестве первого аргумента, а указанное обновление — в качестве второго аргумента.- Параметры:
-
i— индекс -
x— значение для обновления -
accumulatorFunction— функция двух аргументов без побочных эффектов - Возвращает:
- обновленное значение
- Начиная с версии:
- 1.8
toString
getPlain
public final int getPlain(int i)
Возвращает текущее значение элемента с индексом
i; семантика памяти при чтении соответствует случаю, когда переменная объявлена как non-volatile.- Параметры:
-
i— индекс - Возвращает:
- значение
- Начиная с версии:
- 9
setPlain
public final void setPlain(int i, int newValue)
Устанавливает для элемента с индексом
i значение newValue; семантика памяти при записи соответствует случаю, когда переменная объявлена как non-volatile и non-final.- Параметры:
-
i— индекс -
newValue— новое значение - Начиная с версии:
- 9
getOpaque
public final int getOpaque(int i)
Возвращает текущее значение элемента с индексом
i; эффекты памяти определяются согласно VarHandle.getOpaque(Object...).- Параметры:
-
i— индекс - Возвращает:
- значение
- Начиная с версии:
- 9
setOpaque
public final void setOpaque(int i, int newValue)
Устанавливает для элемента с индексом
i значение newValue; эффекты памяти определяются согласно VarHandle.setOpaque(Object...).- Параметры:
-
i— индекс -
newValue— новое значение - Начиная с версии:
- 9
getAcquire
public final int getAcquire(int i)
Возвращает текущее значение элемента с индексом
i; эффекты памяти определяются согласно VarHandle.getAcquire(Object...).- Параметры:
-
i— индекс - Возвращает:
- значение
- Начиная с версии:
- 9
setRelease
public final void setRelease(int i, int newValue)
Устанавливает для элемента с индексом
i значение newValue; эффекты памяти определяются согласно VarHandle.setRelease(Object...).- Параметры:
-
i— индекс -
newValue— новое значение - Начиная с версии:
- 9
compareAndExchange
public final int compareAndExchange(int i, int expectedValue, int newValue)
Атомарно устанавливает для элемента с индексом
i значение newValue, если текущее значение элемента, называемое свидетельствующим значением, == expectedValue; эффекты памяти определяются согласно VarHandle.compareAndExchange(Object...).- Параметры:
-
i— индекс -
expectedValue— ожидаемое значение -
newValue— новое значение - Возвращает:
- свидетельствующее значение, которое при успешном выполнении будет совпадать с ожидаемым значением
- Начиная с версии:
- 9
compareAndExchangeAcquire
public final int compareAndExchangeAcquire(int i, int expectedValue, int newValue)
Атомарно устанавливает для элемента с индексом
i значение newValue, если текущее значение элемента, называемое свидетельствующим значением, == expectedValue; эффекты памяти определяются согласно VarHandle.compareAndExchangeAcquire(Object...).- Параметры:
-
i— индекс -
expectedValue— ожидаемое значение -
newValue— новое значение - Возвращает:
- свидетельствующее значение, которое при успешном выполнении будет совпадать с ожидаемым значением
- Начиная с версии:
- 9
compareAndExchangeRelease
public final int compareAndExchangeRelease(int i, int expectedValue, int newValue)
Атомарно устанавливает для элемента с индексом
i значение newValue, если текущее значение элемента, называемое свидетельствующим значением, == expectedValue; эффекты памяти определяются согласно VarHandle.compareAndExchangeRelease(Object...).- Параметры:
-
i— индекс -
expectedValue— ожидаемое значение -
newValue— новое значение - Возвращает:
- свидетельствующее значение, которое при успешном выполнении будет совпадать с ожидаемым значением
- Начиная с версии:
- 9
weakCompareAndSetVolatile
public final boolean weakCompareAndSetVolatile(int i, int expectedValue, int newValue)
Возможно, атомарно устанавливает для элемента с индексом
i значение newValue, если текущее значение элемента == expectedValue; эффекты памяти определяются согласно VarHandle.weakCompareAndSet(Object...).- Параметры:
-
i— индекс -
expectedValue— ожидаемое значение -
newValue— новое значение - Возвращает:
-
true, если операция выполнена успешно - Начиная с версии:
- 9
weakCompareAndSetAcquire
public final boolean weakCompareAndSetAcquire(int i, int expectedValue, int newValue)
Возможно, атомарно устанавливает для элемента с индексом
i значение newValue, если текущее значение элемента == expectedValue; эффекты памяти определяются согласно VarHandle.weakCompareAndSetAcquire(Object...).- Параметры:
-
i— индекс -
expectedValue— ожидаемое значение -
newValue— новое значение - Возвращает:
-
true, если операция выполнена успешно - Начиная с версии:
- 9
weakCompareAndSetRelease
public final boolean weakCompareAndSetRelease(int i, int expectedValue, int newValue)
Возможно, атомарно устанавливает для элемента с индексом
i значение newValue, если текущее значение элемента == expectedValue; эффекты памяти определяются согласно VarHandle.weakCompareAndSetRelease(Object...).- Параметры:
-
i— индекс -
expectedValue— ожидаемое значение -
newValue— новое значение - Возвращает:
-
true, если операция выполнена успешно - Начиная с версии:
- 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/concurrent/atomic/AtomicIntegerArray.html
compareAndExchange(int, int, int)иcompareAndSet(int, int, int)).