compact1, compact2, compact3

java.util.concurrent.atomic

Class AtomicLongArray

java.lang.Object

java.util.concurrent.atomic.AtomicLongArray

All Implemented Interfaces:

Serializable

public class AtomicLongArray
extends Object
implements Serializable

A long数组，其中元素可以原子更新。 有关原子变量属性的描述，请参阅java.util.concurrent.atomic封装规范。

从以下版本开始：

1.5

另请参见：

Serialized Form

构造方法摘要

构造方法

Constructor and Description
AtomicLongArray(int length) 创建给定长度的新AtomicLongArray，所有元素最初为零。
AtomicLongArray(long[] array) 创建一个与原始数组相同长度的新的AtomicLongArray，并复制所有元素。

方法摘要

Modifier and Type	Method and Description
long	accumulateAndGet(int i, long x, LongBinaryOperator accumulatorFunction) 以索引 i原子更新元素，并将给定函数应用于当前值和给定值，返回更新后的值。
long	addAndGet(int i, long delta) 原子地将索引 i的给定值添加到元素。
boolean	compareAndSet(int i, long expect, long update) 如果当前值 ==为预期值，则 i地将位置 i处的元素设置为给定的更新值。
long	decrementAndGet(int i) 索引 i的元素原子 i 。
long	get(int i) 获取位置 i的当前值。
long	getAndAccumulate(int i, long x, LongBinaryOperator accumulatorFunction) 以索引 i原子更新元素，并将给定函数应用于当前值和给定值，返回上一个值。
long	getAndAdd(int i, long delta) 原子地将给定的值添加到索引 i中的元素。
long	getAndDecrement(int i) 索引 i的元素原子 i 。
long	getAndIncrement(int i) 在索引 i原子上增加一个元素。
long	getAndSet(int i, long newValue) 将位置 i的元素原子设置为给定值并返回旧值。
long	getAndUpdate(int i, LongUnaryOperator updateFunction) 以索引 i原子更新应用给定函数的结果，返回上一个值。
long	incrementAndGet(int i) 索引号为 i的元素原子地增加一个。
void	lazySet(int i, long newValue) 最终将位置 i的元素设置为给定值。
int	length() 返回数组的长度。
void	set(int i, long newValue) 将位置 i处的元素设置为给定值。
String	toString() 返回数组的当前值的String表示形式。
long	updateAndGet(int i, LongUnaryOperator updateFunction) 用索引 i的元素原子更新应用给定函数的结果，返回更新后的值。
boolean	weakCompareAndSet(int i, long expect, long update) 如果当前值 ==为预期值，则 i地将位置 i处的元素设置为给定的更新值。

Methods inherited from class 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 - array复制元素的数组

异常

NullPointerException - 如果数组为空

方法详细信息

length

public final int length()

返回数组的长度。

结果

数组的长度

get

public final long get(int i)

获取位置 i的当前值。

参数

i - 指数

结果

当前值

set

public final void set(int i,
                      long newValue)

将位置 i处的元素设置为给定值。

参数

i - 指数

newValue - 新的价值

lazySet

public final void lazySet(int i,
                          long newValue)

最终将位置 i的元素设置为给定值。

参数

i - 指数

newValue - 新价值

从以下版本开始：

1.6

getAndSet

public final long getAndSet(int i,
                            long newValue)

将位置 i处的元素原子设置为给定值并返回旧值。

参数

i - 指数

newValue - 新价值

结果

以前的值

compareAndSet

public final boolean compareAndSet(int i,
                                   long expect,
                                   long update)

如果当前值 ==为预期值，则 i地将位置 i处的元素设置为给定的更新值。

参数

i - 指数

expect - 预期值

update - 新价值

结果

true如果成功。 False return表示实际值不等于预期值。

weakCompareAndSet

public final boolean weakCompareAndSet(int i,
                                       long expect,
                                       long update)

如果当前值==为预期值，则i地将位置i处的元素设置为给定的更新值。

May fail spuriously and does not provide ordering guarantees ，所以只是很少适合替代compareAndSet 。

参数

i - 指数

expect - 预期值

update - 新价值

结果

true如果成功

getAndIncrement

public final long getAndIncrement(int i)

索引号为i的原子按一个元素 i 。

参数

i - 指数

结果

以前的值

getAndDecrement

public final long getAndDecrement(int i)

索引 i的元素原子减少一个。

参数

i - 指数

结果

以前的值

getAndAdd

public final long getAndAdd(int i,
                            long delta)

原子地将索引 i的给定值添加到元素。

参数

i - 索引

delta - 要添加的值

结果

以前的值

incrementAndGet

public final long incrementAndGet(int i)

按索引 i原子地增加一个元素。

参数

i - 索引

结果

更新的值

decrementAndGet

public final long decrementAndGet(int i)

索引 i的元素原子 i 。

参数

i - 索引

结果

更新的值

addAndGet

public long addAndGet(int i,
                      long delta)

在索引原子将给定值的元素 i 。

参数

i - 指数

delta - 要添加的值

结果

更新的值

getAndUpdate

public final long getAndUpdate(int i,
                               LongUnaryOperator updateFunction)

用索引i原子更新应用给定函数的结果，返回上一个值。 该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。

参数

i - 指数

updateFunction - 无副作用的功能

结果

以前的值

从以下版本开始：

1.8

updateAndGet

public final long updateAndGet(int i,
                               LongUnaryOperator updateFunction)

用索引i的元素进行原子更新，并应用给定的函数，返回更新的值。 该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。

参数

i - 指数

updateFunction - 无副作用的功能

结果

更新的值

从以下版本开始：

1.8

getAndAccumulate

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

以索引i原子更新元素，并将给定函数应用于当前值和给定值，返回上一个值。 该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。 该函数应用索引i作为其第一个参数的当前值，给定更新作为第二个参数。

参数

i - 索引

x - 更新值

accumulatorFunction - 两个参数的无效副作用

结果

以前的值

从以下版本开始：

1.8

accumulateAndGet

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

以索引i原子更新元素，并将给定函数应用于当前值和给定值，返回更新后的值。 该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。 该函数应用索引i作为其第一个参数的当前值，给定更新作为第二个参数。

参数

i - 指数

x - 更新值

accumulatorFunction - 两个参数的无效副作用

结果

更新的值

从以下版本开始：

1.8

toString

public String toString()

返回数组的当前值的String表示形式。

重写：

toString在类别 Object

结果

数组的当前值的String表示形式