Spec-Zone.ru › OpenJDK 27

Класс 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 той же длины, что и заданный массив, копируя из него все элементы.

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

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

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
Модификатор и тип Метод Описание
protected Object clone()
Создает и возвращает копию этого объекта.
boolean equals(Object obj)
Указывает, равен ли этот объект другому объекту.
protected void finalize()
Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии.
Финализация устарела и подлежит удалению в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
int hashCode()
Возвращает хеш-код этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно вследствие уведомления или прерывания.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно вследствие уведомления или прерывания, либо до истечения заданного промежутка реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно вследствие уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

AtomicIntegerArray

public AtomicIntegerArray(int length)
Создает новый AtomicIntegerArray заданной длины, все элементы которого изначально равны нулю.
Параметры:
length — длина массива

AtomicIntegerArray

public AtomicIntegerArray(int[] array)
Создает новый AtomicIntegerArray той же длины, что и заданный массив, копируя из него все элементы.
Параметры:
array — массив, из которого копируются элементы
Исключения:
NullPointerException — если array равен 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(int, int, int)

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)
Атомарно обновляет элемент с индексом i результатом применения заданной функции (с эффектами памяти, указанными в VarHandle.compareAndSet(Object...)) и возвращает предыдущее значение. Функция не должна иметь побочных эффектов, поскольку она может быть применена повторно, если попытки обновления завершаются неудачей из-за конкуренции между потоками.
Параметры:
i — индекс
updateFunction — функция без побочных эффектов
Возвращает:
предыдущее значение
С версии:
1.8

updateAndGet

public final int updateAndGet(int i, IntUnaryOperator updateFunction)
Атомарно обновляет элемент с индексом i результатом применения заданной функции (с эффектами памяти, указанными в VarHandle.compareAndSet(Object...)) и возвращает обновленное значение. Функция не должна иметь побочных эффектов, поскольку она может быть применена повторно, если попытки обновления завершаются неудачей из-за конкуренции между потоками.
Параметры:
i — индекс
updateFunction — функция без побочных эффектов
Возвращает:
обновленное значение
С версии:
1.8

getAndAccumulate

public final int getAndAccumulate(int i, int x, IntBinaryOperator accumulatorFunction)
Атомарно обновляет элемент с индексом i результатом применения заданной функции к текущему и заданному значениям (с эффектами памяти, указанными в VarHandle.compareAndSet(Object...)) и возвращает предыдущее значение. Функция не должна иметь побочных эффектов, поскольку она может быть применена повторно, если попытки обновления завершаются неудачей из-за конкуренции между потоками. Функция получает в качестве первого аргумента текущее значение элемента с индексом i, а в качестве второго — заданное значение обновления.
Параметры:
i — индекс
x — значение обновления
accumulatorFunction — функция двух аргументов без побочных эффектов
Возвращает:
предыдущее значение
С версии:
1.8

accumulateAndGet

public final int accumulateAndGet(int i, int x, IntBinaryOperator accumulatorFunction)
Атомарно обновляет элемент с индексом i результатом применения заданной функции к текущему и заданному значениям (с эффектами памяти, указанными в VarHandle.compareAndSet(Object...)) и возвращает обновленное значение. Функция не должна иметь побочных эффектов, поскольку она может быть применена повторно, если попытки обновления завершаются неудачей из-за конкуренции между потоками. Функция получает в качестве первого аргумента текущее значение элемента с индексом 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(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

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе документации Java SE, содержащем более подробные описания для разработчиков, обзоры основных понятий, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2026, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API