AtomicLong (Java Platform SE 8)

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`	`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()`	現在の値を1だけ原子的に増分します。
`long`	`getAndSet(long newValue)`	指定された値に原子的に設定して、以前の値を返します。
`long`	`getAndUpdate(LongUnaryOperator updateFunction)`	現在の値を、指定された関数を適用した結果で原子的に更新し、前の値を返します。
`long`	`incrementAndGet()`	現在の値を1だけ原子的に増分します。
`int`	`intValue()`	この`AtomicLong`の縮小プリミティブ変換後の値を`int`として返します。
`void`	`lazySet(long newValue)`	指定された値に最終的に設定します。
`long`	`longValue()`	この`AtomicLong`の値を`long`として返します。
`void`	`set(long newValue)`	指定された値に設定します。
`String`	`toString()`	現在値の文字列表記を返します。
`long`	`updateAndGet(LongUnaryOperator updateFunction)`	現在の値を、指定された関数を適用した結果で原子的に更新し、更新された値を返します。
`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 - 追加する値
    
    戻り値:
    
    更新された値
  - 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の縮小プリミティブ変換後の値をintとして返します。
    
    定義:
    
    intValue、クラスNumber
    
    戻り値:
    
    このオブジェクトが表す数値をint型に変換した値。
    
    『Java™言語仕様』を参照してください。
    
    5.1.3 縮小プリミティブ変換
  - longValue
```
public long longValue()
```
    このAtomicLongの値をlongとして返します。
    
    定義:
    
    longValue、クラスNumber
    
    戻り値:
    
    このオブジェクトが表す数値をlong型に変換した値。
  - floatValue
```
public float floatValue()
```
    このAtomicLongの拡張プリミティブ変換後の値をfloatとして返します。
    
    定義:
    
    floatValue、クラスNumber
    
    戻り値:
    
    このオブジェクトが表す数値をfloat型に変換した値。
    
    『Java™言語仕様』を参照してください。
    
    5.1.2 拡張プリミティブ変換
  - doubleValue
```
public double doubleValue()
```
    このAtomicLongの拡張プリミティブ変換後の値をdoubleとして返します。
    
    定義:
    
    doubleValue、クラスNumber
    
    戻り値:
    
    このオブジェクトが表す数値をdouble型に変換した値。
    
    『Java™言語仕様』を参照してください。
    
    5.1.2 拡張プリミティブ変換

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。

クラスAtomicLong

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

メソッドのサマリー

クラス java.lang. Numberから継承されたメソッド

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