JavaTM 2 Platform
Standard Ed. 6

java.util.concurrent.atomic
類別 AtomicInteger

java.lang.Object
  繼承者 java.lang.Number
      繼承者 java.util.concurrent.atomic.AtomicInteger
所有已實作的介面:
Serializable

public class AtomicInteger
extends Number
implements Serializable

可以用原子方式更新的 int 值。有關原子變數屬性的描述,請參閱 java.util.concurrent.atomic 套件規範。AtomicInteger 可用在應用程序中(如以原子方式增加的計數器),並且不能用於替換 Integer。但是,此類別確實擴展了 Number,允許那些處理基於數字類別的工具和實用工具進行統一存取。

從以下版本開始:
1.5
另請參見:
序列化表格

建構子摘要
AtomicInteger()
          創建具有初始值 0 的新 AtomicInteger。
AtomicInteger(int initialValue)
          創建具有給定初始值的新 AtomicInteger。
 
方法摘要
 int addAndGet(int delta)
          以原子方式將給定值與當前值相加。
 boolean compareAndSet(int expect, int update)
          如果當前值 == 預期值,則以原子方式將該值設置為給定的更新值。
 int decrementAndGet()
          以原子方式將當前值減 1。
 double doubleValue()
          以 double 形式返回指定的數值。
 float floatValue()
          以 float 形式返回指定的數值。
 int get()
          獲取當前值。
 int getAndAdd(int delta)
          以原子方式將給定值與當前值相加。
 int getAndDecrement()
          以原子方式將當前值減 1。
 int getAndIncrement()
          以原子方式將當前值加 1。
 int getAndSet(int newValue)
          以原子方式設置為給定值,並返回舊值。
 int incrementAndGet()
          以原子方式將當前值加 1。
 int intValue()
          以 int 形式返回指定的數值。
 void lazySet(int newValue)
          最後設置為給定值。
 long longValue()
          以 long 形式返回指定的數值。
 void set(int newValue)
          設置為給定值。
 String toString()
          返回當前值的字元串表示形式。
 boolean weakCompareAndSet(int expect, int update)
          如果當前值 == 預期值,則以原子方式將該設置為給定的更新值。
 
從類別 java.lang.Number 繼承的方法
byteValue, shortValue
 
從類別 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

建構子詳細資訊

AtomicInteger

public AtomicInteger(int initialValue)
創建具有給定初始值的新 AtomicInteger。

參數:
initialValue - 初始值

AtomicInteger

public AtomicInteger()
創建具有初始值 0 的新 AtomicInteger。

方法詳細資訊

get

public final int get()
獲取當前值。

返回:
當前值

set

public final void set(int newValue)
設置為給定值。

參數:
newValue - 新值

lazySet

public final void lazySet(int newValue)
最後設置為給定值。

參數:
newValue - 新值
從以下版本開始:
1.6

getAndSet

public final int getAndSet(int newValue)
以原子方式設置為給定值,並返回舊值。

參數:
newValue - 新值
返回:
以前的值

compareAndSet

public final boolean compareAndSet(int expect,
                                   int update)
如果當前值 == 預期值,則以原子方式將該值設置為給定的更新值。

參數:
expect - 預期值
update - 新值
返回:
如果成功,則返回 true。返回 False 指示實際值與預期值不相等。

weakCompareAndSet

public final boolean weakCompareAndSet(int expect,
                                       int update)
如果當前值 == 預期值,則以原子方式將該設置為給定的更新值。

可能意外失敗並且不提供排序保證,所以只有在很少的情況下才對 compareAndSet 進行適當地選擇。

參數:
expect - 預期值
update - 新值
返回:
如果成功,則返回 true。

getAndIncrement

public final int getAndIncrement()
以原子方式將當前值加 1。

返回:
以前的值

getAndDecrement

public final int getAndDecrement()
以原子方式將當前值減 1。

返回:
以前的值

getAndAdd

public final int getAndAdd(int delta)
以原子方式將給定值與當前值相加。

參數:
delta - 要加上的值
返回:
以前的值

incrementAndGet

public final int incrementAndGet()
以原子方式將當前值加 1。

返回:
更新的值

decrementAndGet

public final int decrementAndGet()
以原子方式將當前值減 1。

返回:
更新的值

addAndGet

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

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only