ava.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
类型后该对象表示的数值。
-
转换为