Java java.util.concurrent.atomic 类 AtomicInteger（JDK5）

所有类

概述  软件包   类  使用  树  已过时  索引  帮助
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

java.util.concurrent.atomic
类 AtomicInteger

java.lang.Object
  java.lang.Number
      java.util.concurrent.atomic.AtomicInteger

所有已实现的接口：

Serializable

---

public class AtomicInteger
   
   
   
   
   
extends Number
   
   
   
   
   
   
   
   
   
   
implements Serializable
   
   
   
   
   

可以用原子方式更新的 int 值。有关原子变量属性的描述，请参阅 java.util.concurrent.atomic 包规范。AtomicInteger 可用在应用程序中（如以原子方式增加的计数器），并且不能用于替换 Integer。但是，此类确实扩展了 Number，允许那些处理基于数字类的工具和实用工具进行统一访问。

从以下版本开始：

1.5

另请参见：

序列化表格

---

构造方法摘要
AtomicInteger()           使用初始值 0 创建新的 AtomicInteger。
AtomicInteger(int initialValue)           使用给定的初始值创建新的 AtomicInteger。

 

方法摘要
int	addAndGet(int delta)           以原子方式将给定值与当前值相加。
boolean	compareAndSet(int expect, int update)           如果当前值 == 预期值，则以原子方式将该值设置为给定的更新值。
int	decrementAndGet()           以原子方式将当前值减 1。
double	doubleValue()           以 double 形式返回指定的数值。
float	floatValue()           以 float 形式返回指定的数值。
int	get()           获取当前值。
int	getAndAdd(int delta)           以原子方式将给定值与当前值相加。
int	getAndDecrement()           以原子方式将当前值减 1。
int	getAndIncrement()           以原子方式将当前值加 1。
int	getAndSet(int newValue)           设置为给定值，并返回旧值。
int	incrementAndGet()           以原子方式将当前值加 1。
int	intValue()           以 int 形式返回指定的数值。
long	longValue()           以 long 形式返回指定的数值。
void	set(int newValue)           设置为给定值。
String	toString()           返回当前值的字符串表示形式。
boolean	weakCompareAndSet(int expect, int update)           如果当前值 == 预期值，则以原子方式将该设置为给定的更新值。

 

从类 java.lang.Number 继承的方法
byteValue, shortValue

 

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

 

构造方法详细信息

AtomicInteger

public AtomicInteger(int initialValue)

使用给定的初始值创建新的 AtomicInteger。

参数：

initialValue - 初始值

---

AtomicInteger

public AtomicInteger()

使用初始值 0 创建新的 AtomicInteger。

方法详细信息

get

public final int get()

获取当前值。

返回：

当前值

---

set

public final void set(int newValue)

设置为给定值。

参数：

newValue - 新值

---

getAndSet

public final int getAndSet(int newValue)

设置为给定值，并返回旧值。

参数：

newValue - 新值

返回：

以前的值

---

compareAndSet

public final boolean compareAndSet(int expect,
                                   int update)

如果当前值 == 预期值，则以原子方式将该值设置为给定的更新值。

参数：

expect - 预期值

update - 新值

返回：

如果成功，则返回 true。返回 False 指示实际值与预期值不相等。

---

weakCompareAndSet

public final boolean weakCompareAndSet(int expect,
                                       int update)

如果当前值 == 预期值，则以原子方式将该设置为给定的更新值。可能意外失败。

参数：

expect - 预期值

update - 新值

返回：

如果成功，则返回 true。

---

getAndIncrement

public final int getAndIncrement()

以原子方式将当前值加 1。

返回：

以前的值