目录搜索
文字
分享


JavaTM 2 Platform
Standard Ed. 6

java.util.concurrent.atomic
类 AtomicLong

1

2

3

java.lang.Object

  <img src="../../../../resources/inherit.gif" alt="继承者 ">java.lang.Number

      <img src="../../../../resources/inherit.gif" alt="继承者 "><b>java.util.concurrent.atomic.AtomicLong</b>

所有已实现的接口:
Serializable

1

public class <b>AtomicLong</b>

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

1

public <b>AtomicLong</b>(long initialValue)

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

参数:
initialValue - 初始值

AtomicLong

1

public <b>AtomicLong</b>()

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

方法详细信息

get

1

public final long <b>get</b>()

获取当前值。

返回:
当前值

set

1

public final void <b>set</b>(long newValue)

设置为给定值。

参数:
newValue - 新值

lazySet

1

public final void <b>lazySet</b>(long newValue)

最后设置为给定值。

参数:
newValue - 新值
从以下版本开始:
1.6

getAndSet

1

public final long <b>getAndSet</b>(long newValue)

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

参数:
newValue - 新值
返回:
以前的值

compareAndSet

1

2

public final boolean <b>compareAndSet</b>(long expect,

                                   long update)

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

参数:
expect - 预期值
update - 新值
返回:
如果成功,则返回 true。返回 false 指示实际值与预期值不相等。

weakCompareAndSet

1

2

public final boolean <b>weakCompareAndSet</b>(long expect,

                                       long update)

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

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

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

getAndIncrement

1

public final long <b>getAndIncrement</b>()

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

返回:
以前的值

getAndDecrement

1

public final long <b>getAndDecrement</b>()

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

返回:
以前的值

getAndAdd

1

public final long <b>getAndAdd</b>(long delta)

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

参数:
delta - 要添加的值
返回:
以前的值

incrementAndGet

1

public final long <b>incrementAndGet</b>()

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

返回:
更新的值

decrementAndGet

1

public final long <b>decrementAndGet</b>()

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

返回:
更新的值

addAndGet

1

public final long <b>addAndGet</b>(long delta)

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

参数:
delta - 要添加的值
返回:
更新的值

toString

1

public String <b>toString</b>()

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

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

intValue

1

public int <b>intValue</b>()

从类 Number 复制的描述
int 形式返回指定的数值。这可能会涉及到舍入或取整。

指定者:
Number 中的 intValue
返回:
转换为 int 类型后该对象表示的数值。

longValue

1

public long <b>longValue</b>()

从类 Number 复制的描述
long 形式返回指定的数值。这可能涉及到舍入或取整。

指定者:
Number 中的 longValue
返回:
转换为 long 类型后该对象表示的数值。

floatValue

1

public float <b>floatValue</b>()

从类 Number 复制的描述
float 形式返回指定的数值。这可能会涉及到舍入。

指定者:
Number 中的 floatValue
返回:
转换为 float 类型后该对象表示的数值。

doubleValue

1

public double <b>doubleValue</b>()

从类 Number 复制的描述
double 形式返回指定的数值。这可能会涉及到舍入。

指定者:
Number 中的 doubleValue
返回:
转换为 double 类型后该对象表示的数值。

JavaTM 2 Platform
Standard Ed. 6

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

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