- java.lang.Object
-
- java.util.concurrent.atomic.AtomicLongArray
-
- 实现的所有接口
-
Serializable
public class AtomicLongArrayextends Objectimplements Serializable
一个long
数组,其中元素可以原子方式更新。 有关原子访问属性的描述,请参阅VarHandle
规范。- 从以下版本开始:
- 1.5
- 另请参见:
- Serialized Form
-
-
构造方法摘要
构造方法 构造器 描述 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)
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
的元素的当前值,其内存语义为i
,就好像该变量被声明为非volatile
。long
incrementAndGet(int i)
原子地增加索引i
处元素的值,具有由VarHandle.getAndAdd(java.lang.Object...)
指定的记忆效应。void
lazySet(int i, long newValue)
int
length()
返回数组的长度。void
set(int i, long newValue)
void
setOpaque(int i, long newValue)
void
setPlain(int i, long newValue)
将index位置的元件i
至newValue
,与设定为如果该变量被宣布非的存储器语义volatile
和非final
。void
setRelease(int i, long newValue)
String
toString()
返回数组当前值的String表示形式。long
updateAndGet(int i, LongUnaryOperator updateFunction)
原子更新(具有由VarHandle.compareAndSet(java.lang.Object...)
指定的记忆效应)索引i
处的元素以及应用给定函数的结果,返回更新的值。boolean
weakCompareAndSet(int i, long expectedValue, long newValue)
已过时。此方法具有简单的记忆效应,但方法名称意味着易失性记忆效应(请参阅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...)
。
-
-
-
构造方法详细信息
-
AtomicLongArray
public AtomicLongArray(int length)
创建一个给定长度的新AtomicLongArray,所有元素最初为零。- 参数
-
length
- 数组的长度
-
AtomicLongArray
public AtomicLongArray(long[] array)
创建一个新的AtomicLongArray,其长度与从给定数组中复制的所有元素相同。- 参数
-
array
- 要复制元素的数组 - 异常
-
NullPointerException
- 如果array为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
- 新值
-
lazySet
public final void lazySet(int i, long newValue)
- 参数
-
i
- 该指数 -
newValue
- 新值 - 从以下版本开始:
- 1.6
-
getAndSet
public final long getAndSet(int i, long newValue)
- 参数
-
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)
Deprecated.This method has plain memory effects but the method name implies volatile memory effects (see methods such ascompareAndExchange(int, long, long)
andcompareAndSet(int, long, long)
). To avoid confusion over plain or volatile memory effects it is recommended that the methodweakCompareAndSetPlain(int, long, long)
be used instead.可能以原子方式设置在索引元件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
到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
-
getPlain
public final long getPlain(int i)
返回索引为i
的元素的当前值,其内存语义为i
,就好像该变量被声明为非volatile
。- 参数
-
i
- 指数 - 结果
- 价值
- 从以下版本开始:
- 9
-
setPlain
public final void setPlain(int i, long newValue)
将index位置的元件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
- 新值 - 从以下版本开始:
- 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
- 新值 - 从以下版本开始:
- 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
-
-