AtomicIntegerArray (Java Platform SE 8 )

java.lang.Object
- java.util.concurrent.atomic.AtomicIntegerArray

All Implemented Interfaces:

Serializable
```
public class AtomicIntegerArray
extends Object
implements Serializable
```
一个int数组，其中元素可以原子更新。有关原子变量属性的描述，请参阅java.util.concurrent.atomic包规范。

从以下版本开始：

1.5

另请参见：

Serialized Form

构造方法摘要

构造方法
Constructor and Description
`AtomicIntegerArray(int length)` 创建给定长度的新AtomicIntegerArray，所有元素最初为零。
`AtomicIntegerArray(int[] array)` 创建一个新的AtomicIntegerArray，其长度与从给定数组复制的所有元素相同。

方法摘要

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

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造方法详细信息
  - AtomicIntegerArray
```
public AtomicIntegerArray(int length)
```
    创建给定长度的新AtomicIntegerArray，所有元素最初为零。
    
    参数
    
    length - 数组的长度
  - AtomicIntegerArray
```
public AtomicIntegerArray(int[] array)
```
    创建一个新的AtomicIntegerArray，其长度与从给定数组复制的所有元素相同。
    
    参数
    
    array - array复制元素的数组
    
    异常
    
    NullPointerException - 如果数组为空
- 方法详细信息
  - length
```
public final int length()
```
    返回数组的长度。
    
    结果
    
    数组的长度
  - get
```
public final int get(int i)
```
    获取位置 i的当前值。
    
    参数
    
    i - 指数
    
    结果
    
    当前值
  - set
```
public final void set(int i,
                      int newValue)
```
    将位置 i的元素设置为给定值。
    
    参数
    
    i - 指数
    
    newValue - 新价值
  - lazySet
```
public final void lazySet(int i,
                          int newValue)
```
    最终将位置 i的元素设置为给定值。
    
    参数
    
    i - 指数
    
    newValue - 新价值
    
    从以下版本开始：
    
    1.6
  - getAndSet
```
public final int getAndSet(int i,
                           int newValue)
```
    将位置 i的元素原子设置为给定值并返回旧值。
    
    参数
    
    i - 指数
    
    newValue - 新的价值
    
    结果
    
    以前的值
  - compareAndSet
```
public final boolean compareAndSet(int i,
                                   int expect,
                                   int update)
```
    如果当前值 ==为预期值，则 i地将位置 i处的元素设置为给定的更新值。
    
    参数
    
    i - 指数
    
    expect - 期望值
    
    update - 新的价值
    
    结果
    
    true如果成功。 False return表示实际值不等于预期值。
  - weakCompareAndSet
```
public final boolean weakCompareAndSet(int i,
                                       int expect,
                                       int update)
```
    如果当前值==为预期值，则i地将位置i处的元素设置为给定的更新值。
    May fail spuriously and does not provide ordering guarantees ，所以只是很少适合替代compareAndSet 。
    
    参数
    
    i - 指数
    
    expect - 预期值
    
    update - 新价值
    
    结果
    
    true如果成功
  - getAndIncrement
```
public final int getAndIncrement(int i)
```
    在索引 i原子方式递增一个元素。
    
    参数
    
    i - 索引
    
    结果
    
    以前的值
  - getAndDecrement
```
public final int getAndDecrement(int i)
```
    索引 i的元素原子 i 。
    
    参数
    
    i - 指数
    
    结果
    
    以前的值
  - getAndAdd
```
public final int getAndAdd(int i,
                           int delta)
```
    将索引 i的给定值原子地添加到元素。
    
    参数
    
    i - 指数
    
    delta - 要添加的值
    
    结果
    
    以前的值
  - incrementAndGet
```
public final int incrementAndGet(int i)
```
    索引 i处的元素按 i 。
    
    参数
    
    i - 指数
    
    结果
    
    更新的值
  - decrementAndGet
```
public final int decrementAndGet(int i)
```
    索引 i的元素原子 i 。
    
    参数
    
    i - 指数
    
    结果
    
    更新的值
  - addAndGet
```
public final int addAndGet(int i,
                           int delta)
```
    将索引 i的给定值原子地添加到元素。
    
    参数
    
    i - 指数
    
    delta - 要添加的值
    
    结果
    
    更新的值
  - getAndUpdate
```
public final int getAndUpdate(int i,
                              IntUnaryOperator updateFunction)
```
    以索引i原子更新元素，并使用给定函数的结果返回上一个值。该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。
    
    参数
    
    i - 指数
    
    updateFunction - 无副作用的功能
    
    结果
    
    以前的值
    
    从以下版本开始：
    
    1.8
  - updateAndGet
```
public final int updateAndGet(int i,
                              IntUnaryOperator updateFunction)
```
    用索引i原子更新应用给定函数的结果，返回更新后的值。该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。
    
    参数
    
    i - 指数
    
    updateFunction - 无副作用的功能
    
    结果
    
    更新的值
    
    从以下版本开始：
    
    1.8
  - getAndAccumulate
```
public final int getAndAccumulate(int i,
                                  int x,
                                  IntBinaryOperator accumulatorFunction)
```
    以索引i原子更新元素，并将给定函数应用于当前值和给定值，返回上一个值。该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。该函数以索引i作为其第一个参数的当前值应用，给定的更新作为第二个参数。
    
    参数
    
    i - 指数
    
    x - 更新值
    
    accumulatorFunction - 两个参数的无效副作用
    
    结果
    
    以前的值
    
    从以下版本开始：
    
    1.8
  - accumulateAndGet
```
public final int accumulateAndGet(int i,
                                  int x,
                                  IntBinaryOperator accumulatorFunction)
```
    以索引i原子更新元素，并将给定函数应用于当前值和给定值，返回更新后的值。该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。该函数应用索引i作为其第一个参数的当前值，给定的更新作为第二个参数。
    
    参数
    
    i - 索引
    
    x - 更新值
    
    accumulatorFunction - 两个参数的无效副作用
    
    结果
    
    更新的值
    
    从以下版本开始：
    
    1.8
  - toString
```
public String toString()
```
    返回数组的当前值的String表示形式。
    
    重写：
    
    toString在 Object
    
    结果
    
    数组的当前值的String表示形式

Class AtomicIntegerArray

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

AtomicIntegerArray

AtomicIntegerArray

方法详细信息

length

get

set

lazySet

getAndSet

compareAndSet

weakCompareAndSet

getAndIncrement

getAndDecrement

getAndAdd

incrementAndGet

decrementAndGet

addAndGet

getAndUpdate

updateAndGet

getAndAccumulate

accumulateAndGet

toString