AtomicLongArray (Java Platform SE 8 )

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表示形式

Class AtomicLongArray

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

AtomicLongArray

AtomicLongArray

方法详细信息

length

get

set

lazySet

getAndSet

compareAndSet

weakCompareAndSet

getAndIncrement

getAndDecrement

getAndAdd

incrementAndGet

decrementAndGet

addAndGet

getAndUpdate

updateAndGet

getAndAccumulate

accumulateAndGet

toString