java.util.concurrent.atomic.AtomicLong

すべての実装されたインタフェース:: Serializable

public class AtomicLong extends Number implements Serializable

原子的な更新が可能なlong値です。アトミック・アクセスのプロパティの詳細は、VarHandle仕様を参照してください。 AtomicLongは、原子的に増分されるシーケンス番号などのアプリケーションで使用されます。これをLongの代替として使用することはできません。ただし、このクラスはNumberを拡張して、数値ベースのクラスを処理するツールやユーティリティによる単一的なアクセスを許可します。

導入されたバージョン:

1.5

関連項目:

コンストラクタのサマリー

コンストラクタ

コンストラクタ

説明

AtomicLong()

初期値0を使って、新しいAtomicLongを作成します。

AtomicLong(long initialValue)

指定された初期パラメータを使って、新しいAtomicLongを作成します。
メソッドのサマリー

修飾子と型

メソッド

説明

final long

accumulateAndGet(long x, LongBinaryOperator accumulatorFunction)

現在の値を現在の値と指定された値に適用した結果を原子的に更新し、更新された値を返します。

final long

addAndGet(long delta)

VarHandle.getAndAdd(java.lang.Object...)で指定されたメモリー効果を使用して、指定された値を現在の値に原子的に追加します。

final long

compareAndExchange(long expectedValue, long newValue)

現在の値(「証人の価値」、== expectedValue)がVarHandle.compareAndExchange(java.lang.Object...)で指定されているメモリー効果を持つ場合、この値をnewValueに原子的に設定します。

final long

compareAndExchangeAcquire(long expectedValue, long newValue)

現在の値(「証人の価値」、== expectedValue)がVarHandle.compareAndExchangeAcquire(java.lang.Object...)で指定されているメモリー効果を持つ場合、この値をnewValueに原子的に設定します。

final long

compareAndExchangeRelease(long expectedValue, long newValue)

現在の値(「証人の価値」、== expectedValue)がVarHandle.compareAndExchangeRelease(java.lang.Object...)で指定されているメモリー効果を持つ場合、この値をnewValueに原子的に設定します。

final boolean

compareAndSet(long expectedValue, long newValue)

現在の値== expectedValueがnewValueに値を原子的に設定します。VarHandle.compareAndSet(java.lang.Object...)で指定されたメモリー効果があります。

final 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...)で指定されます。

final long

get()

VarHandle.getVolatile(java.lang.Object...)で指定されたメモリー効果を使用して、現在の値を返します。

final long

getAcquire()

VarHandle.getAcquire(java.lang.Object...)で指定されたメモリー効果を使用して、現在の値を返します。

final long

getAndAccumulate(long x, LongBinaryOperator accumulatorFunction)

現在の値を現在の値と与えられた値に適用した結果を元に戻し、前の値を返すことで、現在の値を原子的に更新します。

final long

getAndAdd(long delta)

VarHandle.getAndAdd(java.lang.Object...)で指定されたメモリー効果を使用して、指定された値を現在の値に原子的に追加します。

final long

getAndDecrement()

VarHandle.getAndAdd(java.lang.Object...)で指定されたメモリー効果で、現在の値を原子的に減少させます。

final long

getAndIncrement()

VarHandle.getAndAdd(java.lang.Object...)で指定されたメモリー効果で、現在の値を原子的に増分します。

final long

getAndSet(long newValue)

値をnewValueに原子的に設定し、VarHandle.getAndSet(java.lang.Object...)で指定されたメモリー効果で古い値を返します。

final long

getAndUpdate(LongUnaryOperator updateFunction)

指定された関数を適用した結果で現在の値を原子的に更新し、前の値を返します。

final long

getOpaque()

VarHandle.getOpaque(java.lang.Object...)で指定されたメモリー効果を使用して、現在の値を返します。

final long

getPlain()

変数がvolatile以外と宣言されたかのように、読取りのメモリー・セマンティクスを使用して、現在の値を返します。

final long

incrementAndGet()

VarHandle.getAndAdd(java.lang.Object...)で指定されたメモリー効果で、現在の値を原子的に増分します。

int

intValue()

このAtomicLongの現在の値を、VarHandle.getVolatile(java.lang.Object...)で指定されたメモリー効果を使用して、狭いプリミティブ変換後のintとして返します。

final void

lazySet(long newValue)

値をnewValueに設定し、VarHandle.setRelease(java.lang.Object...)で指定されたメモリー効果を設定します。

long

longValue()

このAtomicLongの現在の値をlongとして返します。VarHandle.getVolatile(java.lang.Object...)で指定されたメモリー効果があります。

final void

set(long newValue)

値をnewValueに設定し、VarHandle.setVolatile(java.lang.Object...)で指定されたメモリー効果を設定します。

final void

setOpaque(long newValue)

値をnewValueに設定し、VarHandle.setOpaque(java.lang.Object...)で指定されたメモリー効果を設定します。

final void

setPlain(long newValue)

値がnewValueに設定され、変数が非volatileおよび非finalとして宣言されているかのように設定されたメモリー・セマンティクスが使用されます。

final void

setRelease(long newValue)

値をnewValueに設定し、VarHandle.setRelease(java.lang.Object...)で指定されたメモリー効果を設定します。

String

toString()

現在値の文字列表記を返します。

final long

updateAndGet(LongUnaryOperator updateFunction)

指定された関数を適用した結果を現在の値に原子的に更新し、更新された値を返します。

final boolean

weakCompareAndSet(long expectedValue, long newValue)

非推奨。
このメソッドは単純なメモリー効果を持ちますが、メソッド名は揮発性メモリー効果(compareAndExchange(long, long)やcompareAndSet(long, long)などのメソッドを参照してください)を意味します。

final boolean

weakCompareAndSetAcquire(long expectedValue, long newValue)

おそらくnewValueに値を原子的に設定します。現在の値== expectedValueの場合は、VarHandle.weakCompareAndSetAcquire(java.lang.Object...)で指定されたメモリー効果が適用されます。

final boolean

weakCompareAndSetPlain(long expectedValue, long newValue)

おそらくnewValueに値を原子的に設定します。現在の値== expectedValueの場合は、VarHandle.weakCompareAndSetPlain(java.lang.Object...)で指定されたメモリー効果が適用されます。

final boolean

weakCompareAndSetRelease(long expectedValue, long newValue)

おそらくnewValueに値を原子的に設定します。現在の値== expectedValueの場合は、VarHandle.weakCompareAndSetRelease(java.lang.Object...)で指定されたメモリー効果が適用されます。

final 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)
  
  現在の値== expectedValueがnewValueに値を原子的に設定します。VarHandle.compareAndSet(java.lang.Object...)で指定されたメモリー効果があります。
  
  パラメータ:
  
  expectedValue - 期待値
  
  newValue - 新しい値
  
  戻り値:
  
  成功する場合はtrue。 falseは、実際の値が予想される値と等価ではないことを示す。
- weakCompareAndSet
  @Deprecated(since="9") public final boolean weakCompareAndSet(long expectedValue, long newValue)
  
  非推奨。
  このメソッドは単純なメモリー効果を持ちますが、メソッド名は揮発性メモリー効果(compareAndExchange(long, long)やcompareAndSet(long, long)などのメソッドを参照してください)を意味します。プレーンまたは揮発性メモリー効果の混乱を避けるために、代わりにweakCompareAndSetPlain(long, long)メソッドを使用することをお勧めします。
  
  おそらく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)
  
  指定された関数を適用した結果で現在の値を原子的に更新し、前の値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。
  
  パラメータ:
  
  updateFunction - 副作用のない関数
  
  戻り値:
  
  前の値
  
  導入されたバージョン:
  
  1.8
- updateAndGet
  
  public final long updateAndGet(LongUnaryOperator updateFunction)
  
  指定された関数を適用した結果を現在の値に原子的に更新し、更新された値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。
  
  パラメータ:
  
  updateFunction - 副作用のない関数
  
  戻り値:
  
  更新された値
  
  導入されたバージョン:
  
  1.8
- getAndAccumulate
  
  public final long getAndAccumulate(long x, LongBinaryOperator accumulatorFunction)
  
  現在の値を現在の値と与えられた値に適用した結果を元に戻し、前の値を返すことで、現在の値を原子的に更新します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。関数は、現在の値を第1引数とし、指定された更新値を第2引数として適用されます。
  
  パラメータ:
  
  x - 更新値
  
  accumulatorFunction - 2つの引数を取る、副作用のない関数
  
  戻り値:
  
  前の値
  
  導入されたバージョン:
  
  1.8
- accumulateAndGet
  
  public final long accumulateAndGet(long x, LongBinaryOperator accumulatorFunction)
  
  現在の値を現在の値と指定された値に適用した結果を原子的に更新し、更新された値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。関数は、現在の値を第1引数とし、指定された更新値を第2引数として適用されます。
  
  パラメータ:
  
  x - 更新値
  
  accumulatorFunction - 2つの引数を取る、副作用のない関数
  
  戻り値:
  
  更新された値
  
  導入されたバージョン:
  
  1.8
- toString
  
  public String toString()
  
  現在値の文字列表記を返します。
  
  オーバーライド:
  
  toString、クラスObject
  
  戻り値:
  
  現在値の文字列表現。
- intValue
  
  public int intValue()
  
  このAtomicLongの現在の値を、VarHandle.getVolatile(java.lang.Object...)で指定されたメモリー効果を使用して、狭いプリミティブ変換後のintとして返します。
  
  定義:
  
  intValue、クラスNumber
  
  戻り値:
  
  このオブジェクトが表す数値をint型に変換した値。
  
  Java言語仕様を参照してください:
  
  5.1.3 プリミティブ・コンバージョンの解説
- longValue
  
  public long longValue()
  
  このAtomicLongの現在の値をlongとして返します。VarHandle.getVolatile(java.lang.Object...)で指定されたメモリー効果があります。 get()と等価です。
  
  定義:
  
  longValue、クラスNumber
  
  戻り値:
  
  このオブジェクトが表す数値をlong型に変換した値。
- floatValue
  
  public float floatValue()
  
  このAtomicLongの現在の値を、拡大プリミティブ変換後のfloatとして返します。メモリー効果は、VarHandle.getVolatile(java.lang.Object...)で指定されます。
  
  定義:
  
  floatValue、クラスNumber
  
  戻り値:
  
  このオブジェクトが表す数値をfloat型に変換した値。
  
  Java言語仕様を参照してください:
  
  5.1.2 プリミティブ変換の強化
- doubleValue
  
  public double doubleValue()
  
  このAtomicLongの現在の値を、拡大プリミティブ変換後のdoubleとして返します。メモリー効果は、VarHandle.getVolatile(java.lang.Object...)で指定されます。
  
  定義:
  
  doubleValue、クラスNumber
  
  戻り値:
  
  このオブジェクトが表す数値をdouble型に変換した値。
  
  Java言語仕様を参照してください:
  
  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)
  
  現在の値(「証人の価値」、== expectedValue)がVarHandle.compareAndExchange(java.lang.Object...)で指定されているメモリー効果を持つ場合、この値をnewValueに原子的に設定します。
  
  パラメータ:
  
  expectedValue - 期待値
  
  newValue - 新しい値
  
  戻り値:
  
  成功した場合に必要な値と同じになる「証人の価値」
  
  導入されたバージョン:
  
  9
- compareAndExchangeAcquire
  
  public final long compareAndExchangeAcquire(long expectedValue, long newValue)
  
  現在の値(「証人の価値」、== expectedValue)がVarHandle.compareAndExchangeAcquire(java.lang.Object...)で指定されているメモリー効果を持つ場合、この値をnewValueに原子的に設定します。
  
  パラメータ:
  
  expectedValue - 期待値
  
  newValue - 新しい値
  
  戻り値:
  
  成功した場合に必要な値と同じになる「証人の価値」
  
  導入されたバージョン:
  
  9
- compareAndExchangeRelease
  
  public final long compareAndExchangeRelease(long expectedValue, long newValue)
  
  現在の値(「証人の価値」、== expectedValue)がVarHandle.compareAndExchangeRelease(java.lang.Object...)で指定されているメモリー効果を持つ場合、この値をnewValueに原子的に設定します。
  
  パラメータ:
  
  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

クラス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