Spec-Zone.ru › OpenJDK 24

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

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

byteValue, shortValue

Методы, объявленные в классе java.lang.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(java.lang.Object...).
Возвращает:
текущее значение

set

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

lazySet

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

getAndSet

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

compareAndSet

public final boolean compareAndSet(long expectedValue, long newValue)
Атомарно устанавливает значение в newValue, если текущее значение == expectedValue, с эффектами памяти, заданными в VarHandle.compareAndSet(java.lang.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(java.lang.Object...).
Параметры:
expectedValue - ожидаемое значение
newValue - новое значение
Возвращает:
true в случае успеха
См. также:
  • weakCompareAndSetPlain(long, long)

weakCompareAndSetPlain

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

getAndIncrement

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

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

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

getAndDecrement

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

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

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

getAndAdd

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

incrementAndGet

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

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

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

decrementAndGet

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

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

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

addAndGet

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

getAndUpdate

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

updateAndGet

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

getAndAccumulate

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

accumulateAndGet

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

toString

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

intValue

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

longValue

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

floatValue

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

doubleValue

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

getPlain

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

setPlain

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

getOpaque

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

setOpaque

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

getAcquire

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

setRelease

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

compareAndExchange

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

compareAndExchangeAcquire

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

compareAndExchangeRelease

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

weakCompareAndSetVolatile

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

weakCompareAndSetAcquire

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

weakCompareAndSetRelease

public final boolean weakCompareAndSetRelease(long expectedValue, long newValue)
Возможно атомарно устанавливает значение в newValue, если текущее значение == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetRelease(java.lang.Object...).
Параметры:
expectedValue - ожидаемое значение
newValue - новое значение
Возвращает:
true, если успешно
Since:
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.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/concurrent/atomic/AtomicLong.html

Spec-Zone.ru

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