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

实现的所有接口

Serializable
```
public class AtomicLong
extends Number
implements Serializable
```
可以原子方式更新的long值。有关原子访问属性的描述，请参阅VarHandle规范。 AtomicLong用于诸如原子递增序列号的应用中，并且不能用作Long的替代物。但是，此类确实扩展了Number以允许通过处理基于数字的类的工具和实用程序进行统一访问。

从以下版本开始：

1.5

另请参见：

Serialized Form

构造方法摘要

构造方法
构造器	描述
`AtomicLong()`	创建一个初始值为 `0`的新AtomicLong。
`AtomicLong(long initialValue)`	使用给定的初始值创建一个新的AtomicLong。

方法摘要

所有方法实例方法具体的方法弃用的方法
变量和类型	方法	描述
`long`	`accumulateAndGet(long x, LongBinaryOperator accumulatorFunction)`	原子更新（具有由 `VarHandle.compareAndSet(java.lang.Object...)`指定的记忆效应）当前值以及将给定函数应用于当前值和给定值的结果，返回更新的值。
`long`	`addAndGet(long delta)`	原子地将给定值添加到当前值，具有由 `VarHandle.getAndAdd(java.lang.Object...)`指定的记忆效应。
`long`	`compareAndExchange(long expectedValue, long newValue)`	原子将值设置为 `newValue`如果当前值，被称为证人值， `== expectedValue`如通过指定，记忆效应 `VarHandle.compareAndExchange(java.lang.Object...)` 。
`long`	`compareAndExchangeAcquire(long expectedValue, long newValue)`	原子将值设置为 `newValue`如果当前值，被称为证人值， `== expectedValue`如通过指定，记忆效应 `VarHandle.compareAndExchangeAcquire(java.lang.Object...)` 。
`long`	`compareAndExchangeRelease(long expectedValue, long newValue)`	原子将值设置为 `newValue`如果当前值，被称为证人值， `== expectedValue`如通过指定，记忆效应 `VarHandle.compareAndExchangeRelease(java.lang.Object...)` 。
`boolean`	`compareAndSet(long expectedValue, long newValue)`	原子将值设置为 `newValue`如果当前值 `== expectedValue`如通过指定，记忆效应 `VarHandle.compareAndSet(java.lang.Object...)` 。
`long`	`decrementAndGet()`	原子地递减当前值，具有由 `VarHandle.getAndAdd(java.lang.Object...)`指定的记忆效应。
`double`	`doubleValue()`	返回此的当前值 `AtomicLong`作为 `double`加宽原始转换后，通过规定的，具有记忆效果 `VarHandle.getVolatile(java.lang.Object...)` 。
`float`	`floatValue()`	在扩展基元转换后，将此 `AtomicLong`的当前值返回为 `float` ，其内存效果由 `VarHandle.getVolatile(java.lang.Object...)`指定。
`long`	`get()`	返回当前值，具有 `VarHandle.getVolatile(java.lang.Object...)`指定的内存效果。
`long`	`getAcquire()`	返回当前值，具有 `VarHandle.getAcquire(java.lang.Object...)`指定的内存效果。
`long`	`getAndAccumulate(long x, LongBinaryOperator accumulatorFunction)`	原子更新（具有由 `VarHandle.compareAndSet(java.lang.Object...)`指定的记忆效应）当前值以及将给定函数应用于当前值和给定值的结果，返回先前的值。
`long`	`getAndAdd(long delta)`	原子地将给定值添加到当前值，具有由 `VarHandle.getAndAdd(java.lang.Object...)`指定的记忆效应。
`long`	`getAndDecrement()`	原子地递减当前值，具有由 `VarHandle.getAndAdd(java.lang.Object...)`指定的记忆效应。
`long`	`getAndIncrement()`	以原子方式递增当前值，具有 `VarHandle.getAndAdd(java.lang.Object...)`指定的记忆效应。
`long`	`getAndSet(long newValue)`	以原子方式将值设置为 `newValue`并返回旧值，并使用 `VarHandle.getAndSet(java.lang.Object...)`指定的内存效果。
`long`	`getAndUpdate(LongUnaryOperator updateFunction)`	原子更新（具有由 `VarHandle.compareAndSet(java.lang.Object...)`指定的记忆效应）当前值和应用给定函数的结果，返回先前的值。
`long`	`getOpaque()`	返回当前值，具有 `VarHandle.getOpaque(java.lang.Object...)`指定的内存效果。
`long`	`getPlain()`	返回当前值，读取的内存语义就像变量声明为非 `volatile` 。
`long`	`incrementAndGet()`	以原子方式递增当前值，具有 `VarHandle.getAndAdd(java.lang.Object...)`指定的记忆效应。
`int`	`intValue()`	返回此的当前值 `AtomicLong`作为 `int`如通过指定一个基本收缩转换之后，与记忆效应 `VarHandle.getVolatile(java.lang.Object...)` 。
`void`	`lazySet(long newValue)`	将值设置为 `newValue` ，具有 `VarHandle.setRelease(java.lang.Object...)`指定的记忆效果。
`long`	`longValue()`	返回此的当前值 `AtomicLong`作为 `long`如通过指定，记忆效应 `VarHandle.getVolatile(java.lang.Object...)` 。
`void`	`set(long newValue)`	将值设置为 `newValue` ，具有 `VarHandle.setVolatile(java.lang.Object...)`指定的记忆效果。
`void`	`setOpaque(long newValue)`	将值设置为 `newValue` ，具有 `VarHandle.setOpaque(java.lang.Object...)`指定的记忆效果。
`void`	`setPlain(long newValue)`	将值设置为 `newValue` ，设置的内存语义就像变量被声明为非 `volatile`和非 `final` 。
`void`	`setRelease(long newValue)`	将值设置为 `newValue` ，具有 `VarHandle.setRelease(java.lang.Object...)`指定的记忆效果。
`String`	`toString()`	返回当前值的String表示形式。
`long`	`updateAndGet(LongUnaryOperator updateFunction)`	原子更新（具有由 `VarHandle.compareAndSet(java.lang.Object...)`指定的记忆效应）当前值和应用给定函数的结果，返回更新的值。
`boolean`	`weakCompareAndSet(long expectedValue, long newValue)`	已过时。此方法具有简单的记忆效应，但方法名称意味着易失性记忆效应（请参阅`compareAndExchange(long, long)`和`compareAndSet(long, long)`等方法）。
`boolean`	`weakCompareAndSetAcquire(long expectedValue, long newValue)`	可能原子将值设置为 `newValue`如果当前值 `== expectedValue`如通过指定，记忆效应 `VarHandle.weakCompareAndSetAcquire(java.lang.Object...)` 。
`boolean`	`weakCompareAndSetPlain(long expectedValue, long newValue)`	可能原子将值设置为 `newValue`如果当前值 `== expectedValue`如通过指定，记忆效应 `VarHandle.weakCompareAndSetPlain(java.lang.Object...)` 。
`boolean`	`weakCompareAndSetRelease(long expectedValue, long newValue)`	可能原子将值设置为 `newValue`如果当前值 `== expectedValue`如通过指定，记忆效应 `VarHandle.weakCompareAndSetRelease(java.lang.Object...)` 。
`boolean`	`weakCompareAndSetVolatile(long expectedValue, long newValue)`	可能原子将值设置为 `newValue`如果当前值 `== expectedValue`如通过指定，记忆效应 `VarHandle.weakCompareAndSet(java.lang.Object...)` 。

声明方法的类 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()
```
    返回当前值，具有 VarHandle.getVolatile(java.lang.Object...)指定的内存效果。
    
    结果
    
    当前的价值
  - set
```
public final void set(long newValue)
```
    将值设置为 newValue ，具有 VarHandle.setVolatile(java.lang.Object...)指定的记忆效果。
    
    参数
    
    newValue - 新值
  - lazySet
```
public final void lazySet(long newValue)
```
    将值设置为 newValue ，具有 VarHandle.setRelease(java.lang.Object...)指定的记忆效果。
    
    参数
    
    newValue - 新值
    
    从以下版本开始：
    
    1.6
  - getAndSet
```
public final long getAndSet(long newValue)
```
    以原子方式将值设置为 newValue并返回旧值，并使用 VarHandle.getAndSet(java.lang.Object...)指定的内存效果。
    
    参数
    
    newValue - 新值
    
    结果
    
    以前的值
  - compareAndSet
```
public final boolean compareAndSet(long expectedValue,
                                   long newValue)
```
    原子将值设置为 newValue如果当前值 == expectedValue如通过指定，记忆效应 VarHandle.compareAndSet(java.lang.Object...) 。
    
    参数
    
    expectedValue - 预期值
    
    newValue - 新值
    
    结果
    
    true如果成功。错误返回表示实际值不等于预期值。
  - weakCompareAndSet
```
@Deprecated(since="9")
public final boolean weakCompareAndSet(long expectedValue,
                                       long newValue)
```
    Deprecated.
    This method has plain memory effects but the method name implies volatile memory effects (see methods such as compareAndExchange(long, long) and compareAndSet(long, long)). To avoid confusion over plain or volatile memory effects it is recommended that the method weakCompareAndSetPlain(long, long) be used instead.
    
    可能原子将值设置为 newValue如果当前值 == expectedValue如通过指定，记忆效应 VarHandle.weakCompareAndSetPlain(java.lang.Object...) 。
    
    参数
    
    expectedValue - 预期值
    
    newValue - 新值
    
    结果
    
    true如果成功
    
    另请参见：
    
    weakCompareAndSetPlain(long, long)
  - weakCompareAndSetPlain
```
public final boolean weakCompareAndSetPlain(long expectedValue,
                                            long newValue)
```
    可能原子将值设置为 newValue如果当前值 == expectedValue如通过指定，记忆效应 VarHandle.weakCompareAndSetPlain(java.lang.Object...) 。
    
    参数
    
    expectedValue - 预期值
    
    newValue - 新值
    
    结果
    
    true如果成功
    
    从以下版本开始：
    
    9
  - getAndIncrement
```
public final long getAndIncrement()
```
    以原子方式递增当前值，具有VarHandle.getAndAdd(java.lang.Object...)指定的记忆效应。
    相当于getAndAdd(1) 。
    
    结果
    
    以前的值
  - getAndDecrement
```
public final long getAndDecrement()
```
    原子地递减当前值，具有由VarHandle.getAndAdd(java.lang.Object...)指定的记忆效应。
    相当于getAndAdd(-1) 。
    
    结果
    
    以前的值
  - getAndAdd
```
public final long getAndAdd(long delta)
```
    原子地将给定值添加到当前值，具有由 VarHandle.getAndAdd(java.lang.Object...)指定的记忆效应。
    
    参数
    
    delta - 要添加的值
    
    结果
    
    以前的值
  - incrementAndGet
```
public final long incrementAndGet()
```
    以原子方式递增当前值，具有VarHandle.getAndAdd(java.lang.Object...)指定的记忆效应。
    相当于addAndGet(1) 。
    
    结果
    
    更新的值
  - decrementAndGet
```
public final long decrementAndGet()
```
    原子地递减当前值，具有由VarHandle.getAndAdd(java.lang.Object...)指定的记忆效应。
    相当于addAndGet(-1) 。
    
    结果
    
    更新的值
  - addAndGet
```
public final long addAndGet(long delta)
```
    原子地将给定值添加到当前值，具有由 VarHandle.getAndAdd(java.lang.Object...)指定的记忆效应。
    
    参数
    
    delta - 要添加的值
    
    结果
    
    更新的值
  - getAndUpdate
```
public final long getAndUpdate(LongUnaryOperator updateFunction)
```
    原子更新（具有由VarHandle.compareAndSet(java.lang.Object...)指定的记忆效应）当前值和应用给定函数的结果，返回先前的值。该函数应该是无副作用的，因为当尝试的更新由于线程之间的争用而失败时，它可能会被重新应用。
    
    参数
    
    updateFunction - 无副作用的功能
    
    结果
    
    以前的值
    
    从以下版本开始：
    
    1.8
  - updateAndGet
```
public final long updateAndGet(LongUnaryOperator updateFunction)
```
    原子更新（具有由VarHandle.compareAndSet(java.lang.Object...)指定的记忆效应）当前值和应用给定函数的结果，返回更新的值。该函数应该是无副作用的，因为当尝试的更新由于线程之间的争用而失败时，它可能会被重新应用。
    
    参数
    
    updateFunction - 无副作用的功能
    
    结果
    
    更新的值
    
    从以下版本开始：
    
    1.8
  - getAndAccumulate
```
public final long getAndAccumulate(long x,
                                   LongBinaryOperator accumulatorFunction)
```
    原子更新（具有由VarHandle.compareAndSet(java.lang.Object...)指定的记忆效应）当前值以及将给定函数应用于当前值和给定值的结果，返回先前值。该函数应该是无副作用的，因为当尝试的更新由于线程之间的争用而失败时，它可能会被重新应用。该函数应用当前值作为其第一个参数，并将给定更新作为第二个参数。
    
    参数
    
    x - 更新值
    
    accumulatorFunction - 两个参数的无副作用函数
    
    结果
    
    以前的值
    
    从以下版本开始：
    
    1.8
  - accumulateAndGet
```
public final long accumulateAndGet(long x,
                                   LongBinaryOperator accumulatorFunction)
```
    原子更新（具有由VarHandle.compareAndSet(java.lang.Object...)指定的记忆效应）当前值以及将给定函数应用于当前值和给定值的结果，返回更新的值。该函数应该是无副作用的，因为当尝试的更新由于线程之间的争用而失败时，它可能会被重新应用。该函数应用当前值作为其第一个参数，并将给定更新作为第二个参数。
    
    参数
    
    x - 更新值
    
    accumulatorFunction - 两个参数的无副作用函数
    
    结果
    
    更新的值
    
    从以下版本开始：
    
    1.8
  - toString
```
public String toString()
```
    返回当前值的String表示形式。
    
    重写：
    
    toString在类 Object
    
    结果
    
    当前值的String表示形式
  - intValue
```
public int intValue()
```
    在缩小基元转换后，返回 AtomicLong的当前值作为 int ，具有由 VarHandle.getVolatile(java.lang.Object...)指定的记忆效应。
    
    Specified by:
    
    intValue在类 Number
    
    结果
    
    转换为类型 int后此对象表示的数值。
    
    See The Java™ Language Specification:
    
    5.1.3缩小原始转换
  - longValue
```
public long longValue()
```
    返回此的当前值AtomicLong作为long如通过指定，记忆效应VarHandle.getVolatile(java.lang.Object...) 。相当于get() 。
    
    Specified by:
    
    longValue在类 Number
    
    结果
    
    转换为类型 long后此对象表示的数值。
  - floatValue
```
public float floatValue()
```
    返回此的当前值 AtomicLong作为 float加宽原始转换后，通过规定的，具有记忆效果 VarHandle.getVolatile(java.lang.Object...) 。
    
    Specified by:
    
    floatValue类 Number
    
    结果
    
    转换为类型 float后此对象表示的数值。
    
    See The Java™ Language Specification:
    
    5.1.2拓宽原始转换
  - doubleValue
```
public double doubleValue()
```
    在扩展基元转换后，返回 AtomicLong的当前值，作为 double ，具有 VarHandle.getVolatile(java.lang.Object...)指定的记忆效应。
    
    Specified by:
    
    doubleValue类 Number
    
    结果
    
    转换为类型 double后此对象表示的数值。
    
    See The Java™ Language Specification:
    
    5.1.2拓宽原始转换
  - getPlain
```
public final long getPlain()
```
    返回当前值，读取的内存语义就像变量声明为非 volatile 。
    
    结果
    
    价值
    
    从以下版本开始：
    
    9
  - setPlain
```
public final void setPlain(long newValue)
```
    将值设置为 newValue ，设置的内存语义就像变量被声明为非 volatile和非 final 。
    
    参数
    
    newValue - 新值
    
    从以下版本开始：
    
    9
  - getOpaque
```
public final long getOpaque()
```
    返回当前值，具有 VarHandle.getOpaque(java.lang.Object...)指定的内存效果。
    
    结果
    
    价值
    
    从以下版本开始：
    
    9
  - setOpaque
```
public final void setOpaque(long newValue)
```
    将值设置为 newValue ，具有 VarHandle.setOpaque(java.lang.Object...)指定的记忆效果。
    
    参数
    
    newValue - 新值
    
    从以下版本开始：
    
    9
  - getAcquire
```
public final long getAcquire()
```
    返回当前值，具有 VarHandle.getAcquire(java.lang.Object...)指定的内存效果。
    
    结果
    
    价值
    
    从以下版本开始：
    
    9
  - setRelease
```
public final void setRelease(long newValue)
```
    将值设置为 newValue ，具有 VarHandle.setRelease(java.lang.Object...)指定的记忆效果。
    
    参数
    
    newValue - 新值
    
    从以下版本开始：
    
    9
  - compareAndExchange
```
public final long compareAndExchange(long expectedValue,
                                     long newValue)
```
    原子将值设置为 newValue如果当前值，被称为 证人值 ， == expectedValue如通过指定，记忆效应 VarHandle.compareAndExchange(java.lang.Object...) 。
    
    参数
    
    expectedValue - 预期值
    
    newValue - 新值
    
    结果
    
    见证值，如果成功则与预期值相同
    
    从以下版本开始：
    
    9
  - compareAndExchangeAcquire
```
public final long compareAndExchangeAcquire(long expectedValue,
                                            long newValue)
```
    原子将值设置为 newValue如果当前值，被称为 证人值 ， == expectedValue如通过指定，记忆效应 VarHandle.compareAndExchangeAcquire(java.lang.Object...) 。
    
    参数
    
    expectedValue - 预期值
    
    newValue - 新值
    
    结果
    
    见证值，如果成功则与预期值相同
    
    从以下版本开始：
    
    9
  - compareAndExchangeRelease
```
public final long compareAndExchangeRelease(long expectedValue,
                                            long newValue)
```
    原子将值设置为 newValue如果当前值，被称为 证人值 ， == expectedValue如通过指定，记忆效应 VarHandle.compareAndExchangeRelease(java.lang.Object...) 。
    
    参数
    
    expectedValue - 预期值
    
    newValue - 新值
    
    结果
    
    见证值，如果成功则与预期值相同
    
    从以下版本开始：
    
    9
  - weakCompareAndSetVolatile
```
public final boolean weakCompareAndSetVolatile(long expectedValue,
                                               long newValue)
```
    可能原子将值设置为 newValue如果当前值 == expectedValue如通过指定，记忆效应 VarHandle.weakCompareAndSet(java.lang.Object...) 。
    
    参数
    
    expectedValue - 预期值
    
    newValue - 新值
    
    结果
    
    true如果成功
    
    从以下版本开始：
    
    9
  - weakCompareAndSetAcquire
```
public final boolean weakCompareAndSetAcquire(long expectedValue,
                                              long newValue)
```
    可能原子将值设置为 newValue如果当前值 == expectedValue如通过指定，记忆效应 VarHandle.weakCompareAndSetAcquire(java.lang.Object...) 。
    
    参数
    
    expectedValue - 预期值
    
    newValue - 新值
    
    结果
    
    true如果成功
    
    从以下版本开始：
    
    9
  - weakCompareAndSetRelease
```
public final boolean weakCompareAndSetRelease(long expectedValue,
                                              long newValue)
```
    可能原子将值设置为 newValue如果当前值 == expectedValue如通过指定，记忆效应 VarHandle.weakCompareAndSetRelease(java.lang.Object...) 。
    
    参数
    
    expectedValue - 预期值
    
    newValue - 新值
    
    结果
    
    true如果成功
    
    从以下版本开始：
    
    9

Class AtomicLong

构造方法摘要

方法摘要

声明方法的类 java.lang.Number

声明方法的类 java.lang.Object

构造方法详细信息

AtomicLong

AtomicLong

方法详细信息

get

set

lazySet

getAndSet

compareAndSet

weakCompareAndSet

weakCompareAndSetPlain

getAndIncrement

getAndDecrement

getAndAdd

incrementAndGet

decrementAndGet

addAndGet

getAndUpdate

updateAndGet

getAndAccumulate

accumulateAndGet

toString

intValue

longValue

floatValue

doubleValue

getPlain

setPlain

getOpaque

setOpaque

getAcquire

setRelease

compareAndExchange

compareAndExchangeAcquire

compareAndExchangeRelease

weakCompareAndSetVolatile

weakCompareAndSetAcquire

weakCompareAndSetRelease