Класс 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 с такой же длиной, как и в заданном массиве, и со всеми элементами, скопированными из заданного массива.

Методы

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

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

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 с результатами применения данной функции, возвращая обновленное значение. Функция должна быть без побочных эффектов, поскольку она может быть применена повторно, когда попытки обновления завершаются неудачей из-за конкуренции между потоками.

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

getAndAccumulate

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

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

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

accumulateAndGet

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

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

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

toString

public String toString()

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

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

getPlain

public final long getPlain(int i)

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

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

setPlain

public final void setPlain(int i,
                           long newValue)

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

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

getOpaque

public final long getOpaque(int i)

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

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

setOpaque

public final void setOpaque(int i,
                            long newValue)

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

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

getAcquire

public final long getAcquire(int i)

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

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

setRelease

public final void setRelease(int i,
                             long newValue)

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

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

compareAndExchange

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

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

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

compareAndExchangeAcquire

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

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

compareAndExchangeRelease

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

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

weakCompareAndSetVolatile

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

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

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

weakCompareAndSetAcquire

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

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

weakCompareAndSetRelease

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

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

© 1993, 2020, 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/11/docs/api/java.base/java/util/concurrent/atomic/AtomicLongArray.html