Класс AtomicLongArray

java.lang.Object

java.util.concurrent.atomic.AtomicLongArray

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

public class AtomicLongArray extends Object implements Serializable

Массив типа long, элементы которого могут быть обновлены атомарно. См. спецификацию VarHandle для описания свойств атомарных операций доступа.

С тех пор:

1.5

См. также:

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

Конструктор	Описание
`AtomicLongArray(int length)`	Создаёт новый AtomicLongArray заданной длины, все элементы которого изначально равны нулю.
`AtomicLongArray(long[] array)`	Создаёт новый AtomicLongArray с такой же длиной, как и заданный массив, и все элементы копируются из этого массива.

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

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

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

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

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

AtomicLongArray

public AtomicLongArray(int length)

Создаёт новый AtomicLongArray заданной длины, все элементы которого изначально равны нулю.

Параметры:: length - длина массива

AtomicLongArray

public AtomicLongArray(long[] array)

Создаёт новый AtomicLongArray с такой же длиной, как и в заданном массиве, и все элементы копируются из заданного массива.

Параметры:: array - массив для копирования элементов
Исключения:: NullPointerException - если массив равен null

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

length

public final int length()

Возвращает длину массива.

Возвращает:: длину массива

get

public final long get(int i)

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

Параметры:: i - индекс
Возвращает:: текущее значение

set

public final void set(int i, long newValue)

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

Параметры:: i - индекс; newValue - новое значение

lazySet

public final void lazySet(int i, long newValue)

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

Параметры:: i - индекс; newValue - новое значение
С тех пор как:: 1.6

getAndSet

public final long getAndSet(int i, long newValue)

Атомарно устанавливает элемент по индексу i в значение


 newValue

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

Параметры:: i - индекс; newValue - новое значение
Возвращает:: предыдущее значение

compareAndSet

public final boolean compareAndSet(int i, long expectedValue, long newValue)

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

Параметры:: i - индекс; expectedValue - ожидаемое значение; newValue - новое значение
Возвращает:: true, если успешно. Возвращение False указывает, что фактическое значение не равно ожидаемому значению.

weakCompareAndSet

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

Устарело.

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

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

Параметры:

i - индекс

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

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

Возвращает:

true, если успешно

См. также:

weakCompareAndSetPlain

public final boolean weakCompareAndSetPlain(int i, long expectedValue, long newValue)

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

getAndIncrement

public final long getAndIncrement(int i)

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

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

Параметры:: i - индекс
Возвращает:: предыдущее значение

getAndDecrement

public final long getAndDecrement(int i)

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

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

Параметры:: i - индекс
Возвращает:: предыдущее значение

getAndAdd

public final long getAndAdd(int i, long delta)

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

Параметры:: i - индекс; delta - значение для добавления
Возвращает:: предыдущее значение

incrementAndGet

public final long incrementAndGet(int i)

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

Параметры:: i - индекс
Возвращает:: обновлённое значение

decrementAndGet

public final long decrementAndGet(int i)

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

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

Параметры:: i - индекс
Возвращает:: обновлённое значение

addAndGet

public long addAndGet(int i, long delta)

Параметры:: i - индекс; delta - значение для добавления
Возвращает:: обновлённое значение

getAndUpdate

public final long getAndUpdate(int i, LongUnaryOperator updateFunction)

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

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

updateAndGet

public final long updateAndGet(int i, LongUnaryOperator updateFunction)

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

Parameters:: i - индекс; updateFunction - функция, свободная от побочных эффектов
Returns:: обновлённое значение
Since:: 1.8

getAndAccumulate

public final long getAndAccumulate(int i, long x, LongBinaryOperator accumulatorFunction)

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

Parameters:: i - индекс; x - значение обновления; accumulatorFunction - функция от двух аргументов, свободная от побочных эффектов
Returns:: предыдущее значение
Since:: 1.8

accumulateAndGet

public final long accumulateAndGet(int i, long x, LongBinaryOperator accumulatorFunction)

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

Parameters:: i - индекс; x - значение обновления; accumulatorFunction - функция от двух аргументов, свободная от побочных эффектов
Returns:: обновлённое значение
Since:: 1.8

toString

public String toString()

Возвращает строковое представление текущих значений массива.

Overrides:: toString в классе Object
Returns:: строковое представление текущих значений массива

getPlain

public final long getPlain(int i)

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

Parameters:: i - индекс
Returns:: значение
Since:: 9

setPlain

public final void setPlain(int i, long newValue)

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

Parameters:: i - индекс; newValue - новое значение
Since:: 9

getOpaque

public final long getOpaque(int i)

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

Parameters:: i - индекс
Returns:: значение
Since:: 9

setOpaque

public final void setOpaque(int i, long newValue)

Устанавливает элемент по индексу i в newValue с эффектами памяти, как указано в VarHandle.setOpaque(java.lang.Object...).

Parameters:: i - индекс; newValue - новое значение
Since:: 9

getAcquire

public final long getAcquire(int i)

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

Parameters:: i - индекс
Returns:: значение
Since:: 9

setRelease

public final void setRelease(int i, long newValue)

Устанавливает элемент по индексу i в newValue с эффектами памяти, как указано в VarHandle.setRelease(java.lang.Object...).

Parameters:: i - индекс; newValue - новое значение
Since:: 9

compareAndExchange

public final long compareAndExchange(int i, long expectedValue, long newValue)

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

Parameters:: i - индекс; expectedValue - ожидаемое значение; newValue - новое значение
Returns:: значение свидетеля, которое будет таким же, как ожидаемое значение, если операция выполнена успешно
Since:: 9

compareAndExchangeAcquire

public final long compareAndExchangeAcquire(int i, long expectedValue, long newValue)

Parameters:: i - индекс; expectedValue - ожидаемое значение; newValue - новое значение
Returns:: значение свидетеля, которое будет таким же, как ожидаемое значение, если операция выполнена успешно
Since:: 9

compareAndExchangeRelease

public final long compareAndExchangeRelease(int i, long expectedValue, long newValue)

Parameters:: i - индекс; expectedValue - ожидаемое значение; newValue - новое значение
Returns:: значение свидетеля, которое будет таким же, как ожидаемое значение, если операция выполнена успешно
Since:: 9

weakCompareAndSetVolatile

public final boolean weakCompareAndSetVolatile(int i, long expectedValue, long newValue)

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

Parameters:: i - индекс; expectedValue - ожидаемое значение; newValue - новое значение
Returns:: true в случае успеха
Since:: 9

weakCompareAndSetAcquire

public final boolean weakCompareAndSetAcquire(int i, long expectedValue, long newValue)

Parameters:: i - индекс; expectedValue - ожидаемое значение; newValue - новое значение
Returns:: true в случае успеха
Since:: 9

END_OF_DOCUMENT_MARKER

weakCompareAndSetRelease

public final boolean weakCompareAndSetRelease(int i, long expectedValue, long newValue)

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

Параметры:: i - индекс; 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/util/concurrent/atomic/AtomicLongArray.html