Класс AtomicInteger

java.lang.Object

java.lang.Number

java.util.concurrent.atomic.AtomicInteger

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

public class AtomicInteger extends Number implements Serializable

Значение int, которое может атомарно обновляться. Описание свойств атомарного доступа см. в спецификации VarHandle. AtomicInteger используется в таких приложениях, как атомарно увеличиваемые счётчики, и не может использоваться вместо Integer. Однако этот класс наследуется от Number, что обеспечивает единообразный доступ для инструментов и утилит, работающих с числовыми классами.

Начиная с:

1.5

См. также:

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

Конструктор	Описание
`AtomicInteger()`	Создаёт новый AtomicInteger с начальным значением `0`.
`AtomicInteger(int initialValue)`	Создаёт новый AtomicInteger с заданным начальным значением.

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

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

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

byteValue, shortValue

Модификатор и тип	Метод	Описание
`byte`	`byteValue()`	Возвращает значение указанного числа как `byte`.
`short`	`shortValue()`	Возвращает значение указанного числа как `short`.

Методы, объявленные в классе 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)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова уведомления или прерывания, либо до истечения заданного промежутка реального времени.

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

AtomicInteger

public AtomicInteger(int initialValue)

Создает новый AtomicInteger с указанным начальным значением.

Параметры:: initialValue — начальное значение

AtomicInteger

public AtomicInteger()

Создает новый AtomicInteger с начальным значением 0.

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

get

public final int get()

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

Возвращает:: текущее значение

set

public final void set(int newValue)

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

Параметры:: newValue — новое значение

lazySet

public final void lazySet(int newValue)

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

Параметры:: newValue — новое значение
С версии:: 1.6

getAndSet

public final int getAndSet(int newValue)

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

Параметры:: newValue — новое значение
Возвращает:: предыдущее значение

compareAndSet

public final boolean compareAndSet(int expectedValue, int newValue)

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

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

weakCompareAndSet

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

Устарел.

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

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

Параметры:

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

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

Возвращает:

true в случае успеха

См. также:

weakCompareAndSetPlain

public final boolean weakCompareAndSetPlain(int expectedValue, int newValue)

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

getAndIncrement

public final int getAndIncrement()

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

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

Возвращает:: предыдущее значение

getAndDecrement

public final int getAndDecrement()

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

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

Возвращает:: предыдущее значение

getAndAdd

public final int getAndAdd(int delta)

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

Параметры:: delta — значение, которое нужно прибавить
Возвращает:: предыдущее значение

incrementAndGet

public final int incrementAndGet()

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

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

Возвращает:: обновленное значение

decrementAndGet

public final int decrementAndGet()

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

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

Возвращает:: обновленное значение

addAndGet

public final int addAndGet(int delta)

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

Параметры:: delta — значение, которое нужно прибавить
Возвращает:: обновленное значение

getAndUpdate

public final int getAndUpdate(IntUnaryOperator updateFunction)

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

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

updateAndGet

public final int updateAndGet(IntUnaryOperator updateFunction)

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

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

getAndAccumulate

public final int getAndAccumulate(int x, IntBinaryOperator accumulatorFunction)

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

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

accumulateAndGet

public final int accumulateAndGet(int x, IntBinaryOperator accumulatorFunction)

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

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

toString

public String toString()

Возвращает строковое представление текущего значения.

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

intValue

public int intValue()

Возвращает текущее значение этого AtomicInteger как int с эффектами памяти, указанными в VarHandle.getVolatile(Object...). Эквивалентно get().

Определено в:: intValue в классе Number
Возвращает:: числовое значение, представленное этим объектом после преобразования к типу int.

longValue

public long longValue()

Возвращает текущее значение этого AtomicInteger как long после расширяющего преобразования примитивного типа с эффектами памяти, указанными в VarHandle.getVolatile(Object...).

Определено в:: longValue в классе Number
Возвращает:: числовое значение, представленное этим объектом после преобразования к типу long.
См. Спецификацию языка Java:: 5.1.2 Расширяющее преобразование примитивного типа

floatValue

public float floatValue()

Возвращает текущее значение этого AtomicInteger как float после расширяющего преобразования примитивного типа с эффектами памяти, указанными в VarHandle.getVolatile(Object...).

Определено в:: floatValue в классе Number
Возвращает:: числовое значение, представленное этим объектом после преобразования к типу float.
См. Спецификацию языка Java:: 5.1.2 Расширяющее преобразование примитивного типа

doubleValue

public double doubleValue()

Возвращает текущее значение этого AtomicInteger как double после расширяющего преобразования примитивного типа с эффектами памяти, указанными в VarHandle.getVolatile(Object...).

Определено в:: doubleValue в классе Number
Возвращает:: числовое значение, представленное этим объектом после преобразования к типу double.
См. Спецификацию языка Java:: 5.1.2 Расширяющее преобразование примитивного типа

getPlain

public final int getPlain()

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

Возвращает:: значение
С версии:: 9

setPlain

public final void setPlain(int newValue)

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

Параметры:: newValue — новое значение
С версии:: 9

getOpaque

public final int getOpaque()

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

Возвращает:: значение
С версии:: 9

setOpaque

public final void setOpaque(int newValue)

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

Параметры:: newValue — новое значение
С версии:: 9

getAcquire

public final int getAcquire()

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

Возвращает:: значение
С версии:: 9

setRelease

public final void setRelease(int newValue)

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

Параметры:: newValue — новое значение
С версии:: 9

compareAndExchange

public final int compareAndExchange(int expectedValue, int newValue)

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

Параметры:: expectedValue — ожидаемое значение; newValue — новое значение
Возвращает:: свидетельствующее значение, которое в случае успеха будет равно ожидаемому значению
С версии:: 9

compareAndExchangeAcquire

public final int compareAndExchangeAcquire(int expectedValue, int newValue)

Параметры:: expectedValue — ожидаемое значение; newValue — новое значение
Возвращает:: свидетельствующее значение, которое в случае успеха будет равно ожидаемому значению
С версии:: 9

compareAndExchangeRelease

public final int compareAndExchangeRelease(int expectedValue, int newValue)

Параметры:: expectedValue — ожидаемое значение; newValue — новое значение
Возвращает:: свидетельствующее значение, которое в случае успеха будет равно ожидаемому значению
С версии:: 9

weakCompareAndSetVolatile

public final boolean weakCompareAndSetVolatile(int expectedValue, int newValue)

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

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

weakCompareAndSetAcquire

public final boolean weakCompareAndSetAcquire(int expectedValue, int newValue)

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

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

weakCompareAndSetRelease

public final boolean weakCompareAndSetRelease(int expectedValue, int newValue)

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

Параметры:: 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.