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

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

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

java.util.concurrent.atomic
类 AtomicLong

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

所有已实现的接口：

Serializable

---

public class AtomicLong
extends Number
implements Serializable

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

从以下版本开始：

1.5

另请参见：

序列化表格

---

构造方法摘要
AtomicLong()           创建具有初始值 0 的新 AtomicLong。
AtomicLong(long initialValue)           创建具有给定初始值的新 AtomicLong。

 

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

 

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

 

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

 

构造方法详细信息

AtomicLong

public AtomicLong(long initialValue)

创建具有给定初始值的新 AtomicLong。

参数：

initialValue - 初始值

---

AtomicLong

public AtomicLong()

创建具有初始值 0 的新 AtomicLong。

方法详细信息

get

public final long get()

获取当前值。

返回：

当前值

---

set

public final void set(long newValue)

设置为给定值。

参数：

newValue - 新值

---

lazySet

public final void lazySet(long newValue)

最后设置为给定值。

参数：

newValue - 新值

从以下版本开始：

1.6

---

getAndSet

public final long getAndSet(long newValue)

以原子方式设置为给定值，并返回旧值。

参数：

newValue - 新值

返回：

以前的值

---

compareAndSet

public final boolean compareAndSet(long expect,
                                   long update)

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

参数：

expect - 预期值

update - 新值

返回：

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

---

weakCompareAndSet

public final boolean weakCompareAndSet(long expect,
                                       long update)

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

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

参数：

expect - 预期值

update - 新值

返回：

如果成功，则返回 true。

---

getAndIncrement

public final long getAndIncrement()

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

返回：

以前的值

---

getAndDecrement

public final long getAndDecrement()

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

返回：

以前的值

---

getAndAdd

public final long getAndAdd(long delta)

以原子方式将给定值添加到当前值。

参数：

delta - 要添加的值

返回：

以前的值

---

incrementAndGet

public final long incrementAndGet()

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

返回：

更新的值

---

decrementAndGet

public final long decrementAndGet()

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

返回：

更新的值

---

addAndGet

public final long addAndGet(long delta)

以原子方式将给定值添加到当前值。

参数：

delta - 要添加的值

返回：

更新的值

---

toString

public String toString()

返回当前值的字符串表示形式。

覆盖：

类 Object 中的 toString

返回：

当前值的字符串表示形式。

---

intValue

public int intValue()

从类 Number 复制的描述

以 int 形式返回指定的数值。这可能会涉及到舍入或取整。

指定者：

类 Number 中的 intValue

返回：

转换为 int 类型后该对象表示的数值。

---

longValue

public long longValue()

从类 Number 复制的描述

以 long 形式返回指定的数值。这可能涉及到舍入或取整。

指定者：

类 Number 中的 longValue

返回：

转换为 long 类型后该对象表示的数值。

---

floatValue

public float floatValue()

从类 Number 复制的描述

以 float 形式返回指定的数值。这可能会涉及到舍入。

指定者：

类 Number 中的 floatValue

返回：

转换为 float 类型后该对象表示的数值。

---

doubleValue

public double doubleValue()

从类 Number 复制的描述

以 double 形式返回指定的数值。这可能会涉及到舍入。

指定者：

类 Number 中的 doubleValue

返回：

转换为 double 类型后该对象表示的数值。

---

概述  软件包   类  使用  树  已过时  索引  帮助		JavaTM Platform Standard Ed. 6
上一个类   下一个类	框架    无框架
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

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

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