JavaTM Platform
Standard Ed. 6

java.util.concurrent.atomic
类 AtomicIntegerArray

java.lang.Object
  继承者 java.util.concurrent.atomic.AtomicIntegerArray
所有已实现的接口:
Serializable

public class AtomicIntegerArray
     
extends Object
implements Serializable

可以用原子方式更新其元素的 int 数组。有关原子变量属性的描述,请参阅 java.util.concurrent.atomic 包规范。

从以下版本开始:
1.5
另请参见:
序列化表格

构造方法摘要
AtomicIntegerArray(int length)
          创建给定长度的新 AtomicIntegerArray。
AtomicIntegerArray(int[] array)
          创建与给定数组具有相同长度的新 AtomicIntegerArray,并从给定数组复制其所有元素。
 
方法摘要
 int addAndGet(int i, int delta)
          以原子方式将给定值与索引 i 的元素相加。
 boolean compareAndSet(int i, int expect, int update)
          如果当前值 == 预期值,则以原子方式将位置 i 的元素设置为给定的更新值。
 int decrementAndGet(int i)
          以原子方式将索引 i 的元素减 1。
 int get(int i)
          获取位置 i 的当前值。
 int getAndAdd(int i, int delta)
          以原子方式将给定值与索引 i 的元素相加。
 int getAndDecrement(int i)
          以原子方式将索引 i 的元素减 1。
 int getAndIncrement(int i)
          以原子方式将索引 i 的元素加 1。
 int getAndSet(int i, int newValue)
          将位置 i 的元素以原子方式设置为给定值,并返回旧值。
 int incrementAndGet(int i)
          以原子方式将索引 i 的元素加 1。
 void lazySet(int i, int newValue)
          最后将位置 i 的元素设置为给定值。
 int length()
          返回该数组的长度。
 void set(int i, int newValue)
          将位置 i 的元素设置为给定值。
 String toString()
          返回数组当前值的字符串表示形式。
 boolean weakCompareAndSet(int i, int expect, int update)
          如果当前值 == 预期值,则以原子方式将位置 i 的元素设置为给定的更新值。
 
从类 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 - 从中复制元素的数组
抛出:
NullPointerException - 如果数组为 null
方法详细信息

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 - 索引
expect - 预期值
update - 新值
返回:
如果成功,则返回 true。返回 false 指示实际值与预期值不相等。

weakCompareAndSet

public final boolean weakCompareAndSet(int i,
                                       int expect,
                                       int update)
如果当前值 == 预期值,则以原子方式将位置 i 的元素设置为给定的更新值。

可能意外失败并且不提供排序保证,所以只是在很少的情况下才对 compareAndSet 进行适当地选择。

参数:
i - 索引
expect - 预期值
update - 新值
返回:
如果成功,则返回 true。

getAndIncrement

public final int getAndIncrement(int i)
以原子方式将索引 i 的元素加 1。

参数:
i - 索引
返回:
以前的值

getAndDecrement

public final int getAndDecrement(int i)
以原子方式将索引 i 的元素减 1。

参数:
i - 索引
返回:
以前的值

getAndAdd

public final int getAndAdd(int i,
                           int delta)
以原子方式将给定值与索引 i 的元素相加。

参数:
i - 索引
delta - 要加上的值
返回:
以前的值

incrementAndGet

public final int incrementAndGet(int i)
以原子方式将索引 i 的元素加 1。

参数:
i - 索引
返回:
更新的值

decrementAndGet

public final int decrementAndGet(int i)
以原子方式将索引 i 的元素减 1。

参数:
i - 索引
返回:
更新的值

addAndGet

public final int addAndGet(int i,
                           int delta)
以原子方式将给定值与索引 i 的元素相加。

参数:
i - 索引
delta - 要加上的值
返回:
更新的值

toString

public String toString()
返回数组当前值的字符串表示形式。

覆盖:
Object 中的 toString
返回:
数组当前值的字符串表示形式。

JavaTM Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策