Spec-Zone.ru › OpenJDK 25

Класс 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

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

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

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(int, int)

weakCompareAndSetPlain

public final boolean weakCompareAndSetPlain(int expectedValue, int newValue)
Возможно, атомарно устанавливает значение newValue, если текущее значение == expectedValue; эффекты памяти соответствуют указанным в VarHandle.weakCompareAndSetPlain(Object...).
Параметры:
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)
Атомарно устанавливает значение newValue, если текущее значение, называемое контрольным значением, == expectedValue; эффекты памяти соответствуют указанным в VarHandle.compareAndExchangeAcquire(Object...).
Параметры:
expectedValue — ожидаемое значение
newValue — новое значение
Возвращает:
контрольное значение, совпадающее с ожидаемым значением в случае успеха
С версии:
9

compareAndExchangeRelease

public final int compareAndExchangeRelease(int expectedValue, int newValue)
Атомарно устанавливает значение newValue, если текущее значение, называемое контрольным значением, == expectedValue; эффекты памяти соответствуют указанным в VarHandle.compareAndExchangeRelease(Object...).
Параметры:
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

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в разделе документации Java SE, содержащем более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и работающие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/concurrent/atomic/AtomicInteger.html

Spec-Zone.ru

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