当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

AtomicIntegerArray (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

---

概述  软件包   类  使用  树  已过时  索引  帮助		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. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。