Класс 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 с такой же длиной, как и в заданном массиве, и со всеми элементами, скопированными из данного массива. |
Краткое описание методов
| Modifier and Type | Method | Description |
|---|---|---|
final int |
accumulateAndGet |
Атомарно обновляет (с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...)) элемент по индексу i результатами применения заданной функции к текущему и заданному значениям, возвращая обновлённое значение. |
final int |
addAndGet |
Атомарно добавляет заданное значение к элементу по индексу i, с эффектами памяти, как указано в VarHandle.getAndAdd(java.lang.Object...). |
final int |
compareAndExchange |
Атомарно устанавливает элемент по индексу i в newValue, если текущее значение элемента, обозначаемое как значение-свидетель, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchange(java.lang.Object...). |
final int |
compareAndExchangeAcquire |
Атомарно устанавливает элемент по индексу i в newValue, если текущее значение элемента, обозначаемое как значение-свидетель, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchangeAcquire(java.lang.Object...). |
final int |
compareAndExchangeRelease |
Атомарно устанавливает элемент по индексу i в newValue, если текущее значение элемента, обозначаемое как значение-свидетель, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchangeRelease(java.lang.Object...). |
final boolean |
compareAndSet |
Атомарно устанавливает элемент по индексу i в
newValue, если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...). |
final int |
decrementAndGet |
Атомарно декрементирует значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getAndAdd(java.lang.Object...). |
final int |
get |
Возвращает текущее значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getVolatile(java.lang.Object...). |
final int |
getAcquire |
Возвращает текущее значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getAcquire(java.lang.Object...). |
final int |
getAndAccumulate |
Атомарно обновляет (с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...)) элемент по индексу i результатами применения заданной функции к текущему и заданному значениям, возвращая предыдущее значение. |
final int |
getAndAdd |
Атомарно добавляет заданное значение к элементу по индексу i, с эффектами памяти, как указано в VarHandle.getAndAdd(java.lang.Object...). |
final int |
getAndDecrement |
Атомарно декрементирует значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getAndAdd(java.lang.Object...). |
final int |
getAndIncrement |
Атомарно инкрементирует значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getAndAdd(java.lang.Object...). |
final int |
getAndSet |
Атомарно устанавливает элемент по индексу i в
newValue и возвращает старое значение, с эффектами памяти, как указано в VarHandle.getAndSet(java.lang.Object...). |
final int |
getAndUpdate |
Атомарно обновляет (с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...)) элемент по индексу i результатами применения заданной функции, возвращая предыдущее значение. |
final int |
getOpaque |
Возвращает текущее значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getOpaque(java.lang.Object...). |
final int |
getPlain |
Возвращает текущее значение элемента по индексу i, с семантикой памяти чтения, как если бы переменная была объявлена не-volatile. |
final int |
incrementAndGet |
Атомарно инкрементирует значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getAndAdd(java.lang.Object...). |
final void |
lazySet |
Устанавливает элемент по индексу i в newValue, с эффектами памяти, как указано в VarHandle.setRelease(java.lang.Object...). |
final int |
length() |
Возвращает длину массива. |
final void |
set |
Устанавливает элемент по индексу i в newValue, с эффектами памяти, как указано в VarHandle.setVolatile(java.lang.Object...). |
final void |
setOpaque |
Устанавливает элемент по индексу i в newValue, с эффектами памяти, как указано в VarHandle.setOpaque(java.lang.Object...). |
final void |
setPlain |
Устанавливает элемент по индексу i в newValue, с семантикой памяти установки, как если бы переменная была объявлена не-volatile и не-final. |
final void |
setRelease |
Устанавливает элемент по индексу i в newValue, с эффектами памяти, как указано в VarHandle.setRelease(java.lang.Object...). |
String |
toString() |
Возвращает строковое представление текущих значений массива. |
final int |
updateAndGet |
Атомарно обновляет (с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...)) элемент по индексу i результатами применения заданной функции, возвращая обновлённое значение. |
final boolean |
weakCompareAndSet |
Устарело. |
final boolean |
weakCompareAndSetAcquire |
Возможно атомарно устанавливает элемент по индексу i в newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetAcquire(java.lang.Object...). |
final boolean |
weakCompareAndSetPlain |
Возможно атомарно устанавливает элемент по индексу i в newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetPlain(java.lang.Object...). |
final boolean |
weakCompareAndSetRelease |
Возможно атомарно устанавливает элемент по индексу i в newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetRelease(java.lang.Object...). |
final boolean |
weakCompareAndSetVolatile |
Возможно атомарно устанавливает элемент по индексу i в newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSet(java.lang.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(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 в значение newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetPlain(java.lang.Object...).- Параметры:
-
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)
Атомарно увеличивает значение элемента по индексу
i, с эффектами памяти, как указано в VarHandle.getAndAdd(java.lang.Object...). Эквивалентно 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, с эффектами памяти, как указано в VarHandle.getAndAdd(java.lang.Object...).- Параметры:
-
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
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 в значение newValue если текущее значение элемента, называемое значение-свидетелем, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchangeAcquire(java.lang.Object...).- Параметры:
-
i- индекс -
expectedValue- ожидаемое значение -
newValue- новое значение - Возвращает:
- значение-свидетель, которое будет таким же, как ожидаемое значение, если операция успешна
- С:
- 9
compareAndExchangeRelease
public final int compareAndExchangeRelease(int i, int expectedValue, int newValue)
Атомарно устанавливает элемент по индексу
i в значение newValue если текущее значение элемента, называемое значение-свидетелем, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchangeRelease(java.lang.Object...).- Параметры:
-
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 в значение newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetAcquire(java.lang.Object...).- Параметры:
-
i- индекс -
expectedValue- ожидаемое значение -
newValue- новое значение - Возвращает:
-
trueесли операция успешна - С:
- 9
weakCompareAndSetRelease
public final boolean weakCompareAndSetRelease(int i, int expectedValue, int newValue)
Возможно атомарно устанавливает элемент по индексу
i в значение newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetRelease(java.lang.Object...).- Параметры:
-
i- индекс -
expectedValue- ожидаемое значение -
newValue- новое значение - Возвращает:
-
trueесли операция успешна - С:
- 9
© 1993, 2021, 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/17/docs/api/java.base/java/util/concurrent/atomic/AtomicIntegerArray.html
compareAndExchange(int, int, int)иcompareAndSet(int, int, int)).