Spec-Zone.ru › OpenJDK 25

Класс AtomicLong

java.lang.Object
java.lang.Number
java.util.concurrent.atomic.AtomicLong
Все реализуемые интерфейсы:
Serializable
public class AtomicLong extends Number implements Serializable
Значение long, которое можно обновлять атомарно. Описание свойств атомарных обращений см. в спецификации VarHandle. AtomicLong используется в приложениях, например, для атомарно увеличиваемых номеров последовательности, и не может служить заменой Long. Однако этот класс расширяет Number, чтобы обеспечить единообразный доступ для инструментов и утилит, работающих с классами, основанными на числах.
Начиная с версии:
1.5
См. также:
  • Сериализованная форма

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

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

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

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

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

byteValue, shortValue

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

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

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

AtomicLong

public AtomicLong(long initialValue)
Создает новый объект AtomicLong с указанным начальным значением.
Параметры:
initialValue — начальное значение

AtomicLong

public AtomicLong()
Создает новый объект AtomicLong с начальным значением 0.

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

get

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

set

public final void set(long newValue)
Устанавливает значение newValue с эффектами памяти, указанными в VarHandle.setVolatile(Object...).
Параметры:
newValue — новое значение

lazySet

public final void lazySet(long newValue)
Устанавливает значение newValue с эффектами памяти, указанными в VarHandle.setRelease(Object...).
Параметры:
newValue — новое значение
С момента выпуска:
1.6

getAndSet

public final long getAndSet(long newValue)
Атомарно устанавливает значение newValue и возвращает старое значение с эффектами памяти, указанными в VarHandle.getAndSet(Object...).
Параметры:
newValue — новое значение
Возвращает:
предыдущее значение

compareAndSet

public final boolean compareAndSet(long expectedValue, long newValue)
Атомарно устанавливает значение newValue, если текущее значение == expectedValue, с эффектами памяти, указанными в VarHandle.compareAndSet(Object...).
Параметры:
expectedValue — ожидаемое значение
newValue — новое значение
Возвращает:
true в случае успеха. Возврат значения false означает, что фактическое значение не совпадало с ожидаемым.

weakCompareAndSet

@Deprecated(since="9") public final boolean weakCompareAndSet(long expectedValue, long newValue)
Устарел.
Этот метод имеет обычные эффекты памяти, но его имя подразумевает эффекты volatile-памяти (см. такие методы, как compareAndExchange(long, long) и compareAndSet(long, long)). Чтобы избежать путаницы относительно обычных или volatile-эффектов памяти, рекомендуется вместо него использовать метод weakCompareAndSetPlain(long, long).
Возможно, атомарно устанавливает значение newValue, если текущее значение == expectedValue, с эффектами памяти, указанными в VarHandle.weakCompareAndSetPlain(Object...).
Параметры:
expectedValue — ожидаемое значение
newValue — новое значение
Возвращает:
true в случае успеха
См. также:
  • weakCompareAndSetPlain(long, long)

weakCompareAndSetPlain

public final boolean weakCompareAndSetPlain(long expectedValue, long newValue)
Возможно, атомарно устанавливает значение newValue, если текущее значение == expectedValue, с эффектами памяти, указанными в VarHandle.weakCompareAndSetPlain(Object...).
Параметры:
expectedValue — ожидаемое значение
newValue — новое значение
Возвращает:
true в случае успеха
С момента выпуска:
9

getAndIncrement

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

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

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

getAndDecrement

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

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

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

getAndAdd

public final long getAndAdd(long delta)
Атомарно прибавляет указанное значение к текущему с эффектами памяти, указанными в VarHandle.getAndAdd(Object...).
Параметры:
delta — прибавляемое значение
Возвращает:
предыдущее значение

incrementAndGet

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

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

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

decrementAndGet

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

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

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

addAndGet

public final long addAndGet(long delta)
Атомарно прибавляет указанное значение к текущему с эффектами памяти, указанными в VarHandle.getAndAdd(Object...).
Параметры:
delta — прибавляемое значение
Возвращает:
обновленное значение

getAndUpdate

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

updateAndGet

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

getAndAccumulate

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

accumulateAndGet

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

toString

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

intValue

public int intValue()
Возвращает текущее значение этого AtomicLong как int после сужающего преобразования примитивного типа с эффектами памяти, указанными в VarHandle.getVolatile(Object...).
Определено в:
intValue в классе Number
Возвращает:
числовое значение, представляемое этим объектом после преобразования к типу int.
См. Спецификацию языка Java:
5.1.3 Сужающее преобразование примитивного типа

longValue

public long longValue()
Возвращает текущее значение этого AtomicLong как long с эффектами памяти, указанными в VarHandle.getVolatile(Object...). Эквивалентно get().
Определено в:
longValue в классе Number
Возвращает:
числовое значение, представляемое этим объектом после преобразования к типу long.

floatValue

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

doubleValue

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

getPlain

public final long getPlain()
Возвращает текущее значение с семантикой чтения памяти, как если бы переменная была объявлена не-volatile.
Возвращает:
значение
С момента выпуска:
9

setPlain

public final void setPlain(long newValue)
Устанавливает значение newValue с семантикой записи в память, как если бы переменная была объявлена не-volatile и не-final.
Параметры:
newValue — новое значение
С момента выпуска:
9

getOpaque

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

setOpaque

public final void setOpaque(long newValue)
Устанавливает значение newValue с эффектами памяти, указанными в VarHandle.setOpaque(Object...).
Параметры:
newValue — новое значение
С момента выпуска:
9

getAcquire

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

setRelease

public final void setRelease(long newValue)
Устанавливает значение newValue с эффектами памяти, указанными в VarHandle.setRelease(Object...).
Параметры:
newValue — новое значение
С момента выпуска:
9

compareAndExchange

public final long compareAndExchange(long expectedValue, long newValue)
Атомарно устанавливает значение newValue, если текущее значение, называемое контрольным значением, == expectedValue, с эффектами памяти, указанными в VarHandle.compareAndExchange(Object...).
Параметры:
expectedValue — ожидаемое значение
newValue — новое значение
Возвращает:
контрольное значение, которое в случае успеха совпадает с ожидаемым значением
С момента выпуска:
9

compareAndExchangeAcquire

public final long compareAndExchangeAcquire(long expectedValue, long newValue)
Атомарно устанавливает значение newValue, если текущее значение, называемое контрольным значением, == expectedValue, с эффектами памяти, указанными в VarHandle.compareAndExchangeAcquire(Object...).
Параметры:
expectedValue — ожидаемое значение
newValue — новое значение
Возвращает:
контрольное значение, которое в случае успеха совпадает с ожидаемым значением
С момента выпуска:
9

compareAndExchangeRelease

public final long compareAndExchangeRelease(long expectedValue, long newValue)
Атомарно устанавливает значение newValue, если текущее значение, называемое контрольным значением, == expectedValue, с эффектами памяти, указанными в VarHandle.compareAndExchangeRelease(Object...).
Параметры:
expectedValue — ожидаемое значение
newValue — новое значение
Возвращает:
контрольное значение, которое в случае успеха совпадает с ожидаемым значением
С момента выпуска:
9

weakCompareAndSetVolatile

public final boolean weakCompareAndSetVolatile(long expectedValue, long newValue)
Возможно, атомарно устанавливает значение newValue, если текущее значение == expectedValue, с эффектами памяти, указанными в VarHandle.weakCompareAndSet(Object...).
Параметры:
expectedValue — ожидаемое значение
newValue — новое значение
Возвращает:
true в случае успеха
С момента выпуска:
9

weakCompareAndSetAcquire

public final boolean weakCompareAndSetAcquire(long expectedValue, long newValue)
Возможно, атомарно устанавливает значение newValue, если текущее значение == expectedValue, с эффектами памяти, указанными в VarHandle.weakCompareAndSetAcquire(Object...).
Параметры:
expectedValue — ожидаемое значение
newValue — новое значение
Возвращает:
true в случае успеха
С момента выпуска:
9

weakCompareAndSetRelease

public final boolean weakCompareAndSetRelease(long expectedValue, long 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/AtomicLong.html

Spec-Zone.ru

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