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 型別後該物件表示的數值。