AtomicLong (Java Platform SE 8 )

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

All Implemented Interfaces:

Serializable
```
public class AtomicLong
extends Number
implements Serializable
```
一个long值可以用原子更新。有关原子变量属性的描述，请参阅java.util.concurrent.atomic包规范。一个AtomicLong用于诸如原子增量的序列号的应用中，不能用作Long的替代物。但是，该类确实扩展了Number ，以允许使用基于数字类的工具和实用程序的统一访问。

从以下版本开始：

1.5

另请参见：

Serialized Form

构造方法摘要

构造方法
Constructor and Description
`AtomicLong()` 创建一个新的AtomicLong，初始值为 `0` 。
`AtomicLong(long initialValue)` 用给定的初始值创建一个新的AtomicLong。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`long`	`accumulateAndGet(long x, LongBinaryOperator accumulatorFunction)` 使用将给定函数应用于当前值和给定值的结果原子更新当前值，返回更新后的值。
`long`	`addAndGet(long delta)` 将给定的值原子地添加到当前值。
`boolean`	`compareAndSet(long expect, long update)` 如果当前值为 `==` ，则将原值设置为给定的更新值。
`long`	`decrementAndGet()` 原子减1当前值。
`double`	`doubleValue()` 返回此值 `AtomicLong`为 `double`一个宽元转换后。
`float`	`floatValue()` 返回此值 `AtomicLong`为 `float`一个宽元转换后。
`long`	`get()` 获取当前值。
`long`	`getAndAccumulate(long x, LongBinaryOperator accumulatorFunction)` 使用给定函数应用给当前值和给定值的结果原子更新当前值，返回上一个值。
`long`	`getAndAdd(long delta)` 将给定的值原子地添加到当前值。
`long`	`getAndDecrement()` 原子减1当前值。
`long`	`getAndIncrement()` 原子上增加一个当前值。
`long`	`getAndSet(long newValue)` 将原子设置为给定值并返回旧值。
`long`	`getAndUpdate(LongUnaryOperator updateFunction)` 用应用给定函数的结果原子更新当前值，返回上一个值。
`long`	`incrementAndGet()` 原子上增加一个当前值。
`int`	`intValue()` 返回此的值 `AtomicLong`作为 `int`的基本收缩转换之后。
`void`	`lazySet(long newValue)` 最终设定为给定值。
`long`	`longValue()` 将 `AtomicLong`的值作为 `long` 。
`void`	`set(long newValue)` 设置为给定值。
`String`	`toString()` 返回当前值的String表示形式。
`long`	`updateAndGet(LongUnaryOperator updateFunction)` 使用给定函数的结果原子更新当前值，返回更新的值。
`boolean`	`weakCompareAndSet(long expect, long update)` 如果当前值为 `==` ，则将原值设置为给定的更新值。

Methods inherited from class java.lang.Number
byteValue, shortValue

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造方法详细信息
  - AtomicLong
```
public AtomicLong(long initialValue)
```
    用给定的初始值创建一个新的AtomicLong。
    
    参数
    
    initialValue - 初始值
  - AtomicLong
```
public AtomicLong()
```
    创建一个新的AtomicLong，初始值为 0 。
- 方法详细信息
  - 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 return表示实际值不等于预期值。
  - weakCompareAndSet
```
public final boolean weakCompareAndSet(long expect,
                                       long update)
```
    如果当前值为== ，则将原值设置为给定的更新值。
    May fail spuriously and does not provide ordering guarantees ，所以只是很少适合替代compareAndSet 。
    
    参数
    
    expect - 预期值
    
    update - 新值
    
    结果
    
    true如果成功
  - getAndIncrement
```
public final long getAndIncrement()
```
    原子上增加一个当前值。
    
    结果
    
    以前的值
  - getAndDecrement
```
public final long getAndDecrement()
```
    原子减1当前值。
    
    结果
    
    以前的值
  - getAndAdd
```
public final long getAndAdd(long delta)
```
    将给定的值原子地添加到当前值。
    
    参数
    
    delta - 要添加的值
    
    结果
    
    以前的值
  - incrementAndGet
```
public final long incrementAndGet()
```
    原子上增加一个当前值。
    
    结果
    
    更新的值
  - decrementAndGet
```
public final long decrementAndGet()
```
    原子减1当前值。
    
    结果
    
    更新的值
  - addAndGet
```
public final long addAndGet(long delta)
```
    将给定的值原子地添加到当前值。
    
    参数
    
    delta - 要添加的值
    
    结果
    
    更新的值
  - getAndUpdate
```
public final long getAndUpdate(LongUnaryOperator updateFunction)
```
    用应用给定函数的结果原子更新当前值，返回上一个值。该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。
    
    参数
    
    updateFunction - 无副作用的功能
    
    结果
    
    以前的值
    
    从以下版本开始：
    
    1.8
  - updateAndGet
```
public final long updateAndGet(LongUnaryOperator updateFunction)
```
    使用给定函数的结果原子更新当前值，返回更新的值。该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。
    
    参数
    
    updateFunction - 无副作用的功能
    
    结果
    
    更新的值
    
    从以下版本开始：
    
    1.8
  - getAndAccumulate
```
public final long getAndAccumulate(long x,
                                   LongBinaryOperator accumulatorFunction)
```
    使用给定函数应用给当前值和给定值的结果原子更新当前值，返回上一个值。该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。该函数应用当前值作为其第一个参数，给定的更新作为第二个参数。
    
    参数
    
    x - 更新值
    
    accumulatorFunction - 两个参数的无效副作用
    
    结果
    
    以前的值
    
    从以下版本开始：
    
    1.8
  - accumulateAndGet
```
public final long accumulateAndGet(long x,
                                   LongBinaryOperator accumulatorFunction)
```
    使用将给定函数应用于当前值和给定值的结果原子更新当前值，返回更新后的值。该功能应该是无副作用的，因为尝试的更新由于线程之间的争用而失败时可能会被重新应用。该函数应用当前值作为其第一个参数，给定的更新作为第二个参数。
    
    参数
    
    x - 更新值
    
    accumulatorFunction - 两个参数的无效副作用
    
    结果
    
    更新的值
    
    从以下版本开始：
    
    1.8
  - toString
```
public String toString()
```
    返回当前值的String表示形式。
    
    重写：
    
    toString在类别 Object
    
    结果
    
    当前值的String表示形式
  - intValue
```
public int intValue()
```
    返回此的值 AtomicLong作为 int的基本收缩转换之后。
    
    Specified by:
    
    intValue在类别 Number
    
    结果
    
    在转换为 int之后由该对象表示的数值。
    
    See The Java™ Language Specification:
    
    5.1.3缩小原始转换
  - longValue
```
public long longValue()
```
    将 AtomicLong的值作为 long 。
    
    Specified by:
    
    longValue在 Number
    
    结果
    
    该对象在转换为 long之后表示的 long 。
  - floatValue
```
public float floatValue()
```
    返回此值 AtomicLong为 float一个宽元转换后。
    
    Specified by:
    
    floatValue在 Number
    
    结果
    
    该对象在转换为 float之后表示的 float 。
    
    See The Java™ Language Specification:
    
    5.1.2扩大原始转换
  - doubleValue
```
public double doubleValue()
```
    返回此值 AtomicLong为 double一个宽元转换后。
    
    Specified by:
    
    doubleValue在类别 Number
    
    结果
    
    该对象在转换为 double之后表示的 double 。
    
    See The Java™ Language Specification:
    
    5.1.2扩大原始转换

Class AtomicLong

构造方法摘要

方法摘要

Methods inherited from class java.lang.Number

Methods inherited from class java.lang.Object

构造方法详细信息

AtomicLong

AtomicLong

方法详细信息

get

set

lazySet

getAndSet

compareAndSet

weakCompareAndSet

getAndIncrement

getAndDecrement

getAndAdd

incrementAndGet

decrementAndGet

addAndGet

getAndUpdate

updateAndGet

getAndAccumulate

accumulateAndGet

toString

intValue

longValue

floatValue

doubleValue