Класс AtomicLongArray
java.lang.Object
java.util.concurrent.atomic.AtomicLongArray
- Все реализованные интерфейсы:
Serializable
public class AtomicLongArray extends Object implements Serializable
Массив
long чисел типа long, элементы которого могут быть обновлены атомарно. См. спецификацию VarHandle для описания свойств атомарных операций доступа.- С тех пор:
- 1.5
- См. также:
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
AtomicLongArray |
Создаёт новый массив AtomicLongArray заданной длины, все элементы которого изначально равны нулю. |
AtomicLongArray |
Создаёт новый массив AtomicLongArray с такой же длиной, как и заданный массив, и с элементами, скопированными из него. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
final long |
accumulateAndGet |
Атомарно обновляет (с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...)) элемент по индексу i с результатами применения данной функции к текущим и заданным значениям, возвращая обновленное значение. |
long |
addAndGet |
Атомарно добавляет заданное значение к элементу по индексу i, с эффектами памяти, как указано в VarHandle.getAndAdd(java.lang.Object...). |
final long |
compareAndExchange |
Атомарно устанавливает элемент по индексу i в newValue если текущее значение элемента, называемое значением-свидетелем, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchange(java.lang.Object...). |
final long |
compareAndExchangeAcquire |
Атомарно устанавливает элемент по индексу i в newValue если текущее значение элемента, называемое значением-свидетелем, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchangeAcquire(java.lang.Object...). |
final long |
compareAndExchangeRelease |
Атомарно устанавливает элемент по индексу i в newValue если текущее значение элемента, называемое значением-свидетелем, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchangeRelease(java.lang.Object...). |
final boolean |
compareAndSet |
Атомарно устанавливает элемент по индексу i в newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...). |
final long |
decrementAndGet |
Атомарно уменьшает значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getAndAdd(java.lang.Object...). |
final long |
get |
Возвращает текущее значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getVolatile(java.lang.Object...). |
final long |
getAcquire |
Возвращает текущее значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getAcquire(java.lang.Object...). |
final long |
getAndAccumulate |
Атомарно обновляет (с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...)) элемент по индексу i с результатами применения данной функции к текущим и заданным значениям, возвращая предыдущее значение. |
final long |
getAndAdd |
Атомарно добавляет заданное значение к элементу по индексу i, с эффектами памяти, как указано в VarHandle.getAndAdd(java.lang.Object...). |
final long |
getAndDecrement |
Атомарно уменьшает значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getAndAdd(java.lang.Object...). |
final long |
getAndIncrement |
Атомарно увеличивает значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getAndAdd(java.lang.Object...). |
final long |
getAndSet |
Атомарно устанавливает элемент по индексу i в
newValue и возвращает старое значение, с эффектами памяти, как указано в VarHandle.getAndSet(java.lang.Object...). |
final long |
getAndUpdate |
Атомарно обновляет (с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...)) элемент по индексу i с результатами применения данной функции, возвращая предыдущее значение. |
final long |
getOpaque |
Возвращает текущее значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getOpaque(java.lang.Object...). |
final long |
getPlain |
Возвращает текущее значение элемента по индексу i, с семантикой памяти чтения, как если бы переменная была объявлена как не-volatile. |
final long |
incrementAndGet |
Атомарно увеличивает значение элемента по индексу i, с эффектами памяти, как указано в VarHandle.getAndAdd(java.lang.Object...). |
final void |
lazySet |
Устанавливает элемент по индексу i в newValue, с эффектами памяти, как указано в VarHandle.setRelease(java.lang.Object...). |
final int |
length() |
Возвращает длину массива. |
final void |
set |
Устанавливает элемент по индексу i в newValue, с эффектами памяти, как указано в VarHandle.setVolatile(java.lang.Object...). |
final void |
setOpaque |
Устанавливает элемент по индексу i в newValue, с эффектами памяти, как указано в VarHandle.setOpaque(java.lang.Object...). |
final void |
setPlain |
Устанавливает элемент по индексу i в newValue, с семантикой памяти установки, как если бы переменная была объявлена как не-volatile и не-final. |
final void |
setRelease |
Устанавливает элемент по индексу i в newValue, с эффектами памяти, как указано в VarHandle.setRelease(java.lang.Object...). |
String |
toString() |
Возвращает строковое представление текущих значений массива. |
final long |
updateAndGet |
Атомарно обновляет (с эффектами памяти, как указано в VarHandle.compareAndSet(java.lang.Object...)) элемент по индексу i с результатами применения данной функции, возвращая обновленное значение. |
final boolean |
weakCompareAndSet |
Устарело. |
final boolean |
weakCompareAndSetAcquire |
Возможно атомарно устанавливает элемент по индексу i в newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetAcquire(java.lang.Object...). |
final boolean |
weakCompareAndSetPlain |
Возможно атомарно устанавливает элемент по индексу i в newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetPlain(java.lang.Object...). |
final boolean |
weakCompareAndSetRelease |
Возможно атомарно устанавливает элемент по индексу i в newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetRelease(java.lang.Object...). |
final boolean |
weakCompareAndSetVolatile |
Возможно атомарно устанавливает элемент по индексу i в newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSet(java.lang.Object...). |
Подробное описание конструкторов
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 в newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetPlain(java.lang.Object...).- Параметры:
-
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)
Атомарно увеличивает значение элемента по индексу
i, с эффектами памяти, как указано в VarHandle.getAndAdd(java.lang.Object...). Эквивалентно 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, с эффектами памяти, как указано в VarHandle.getAndAdd(java.lang.Object...).- Параметры:
-
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 в newValue, если текущее значение элемента, называемое свидетельским значением, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchangeAcquire(java.lang.Object...).- Параметры:
-
i- индекс -
expectedValue- ожидаемое значение -
newValue- новое значение - Возвращает:
- свидетельское значение, которое будет таким же, как ожидаемое значение, если успешно
- С:
- 9
compareAndExchangeRelease
public final long compareAndExchangeRelease(int i, long expectedValue, long newValue)
Атомарно устанавливает элемент по индексу
i в newValue, если текущее значение элемента, называемое свидетельским значением, == expectedValue, с эффектами памяти, как указано в VarHandle.compareAndExchangeRelease(java.lang.Object...).- Параметры:
-
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 в newValue если текущее значение элемента == expectedValue, с эффектами памяти, как указано в VarHandle.weakCompareAndSetAcquire(java.lang.Object...).- Параметры:
-
i- индекс -
expectedValue- ожидаемое значение -
newValue- новое значение - Возвращает:
-
trueесли успешно - С:
- 9
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, 2023, 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/21/docs/api/java.base/java/util/concurrent/atomic/AtomicLongArray.html
compareAndExchange(int, long, long)иcompareAndSet(int, long, long)).