AtomicInteger (Java Platform SE 8)

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`	`accumulateAndGet(int x, IntBinaryOperator accumulatorFunction)`	現在の値を、指定された関数を現在の値と指定された値に適用した結果で原子的に更新し、更新された値を返します。
`int`	`addAndGet(int delta)`	指定された値を現在の値に原子的に追加します。
`boolean`	`compareAndSet(int expect, int update)`	「現在の値`==`予想される値」である場合、値を指定された更新値に原子的に設定します。
`int`	`decrementAndGet()`	現在の値を1だけ原子的に減分します。
`double`	`doubleValue()`	この`AtomicInteger`の拡張プリミティブ変換後の値を`double`として返します。
`float`	`floatValue()`	この`AtomicInteger`の拡張プリミティブ変換後の値を`float`として返します。
`int`	`get()`	現在の値を取得します。
`int`	`getAndAccumulate(int x, IntBinaryOperator accumulatorFunction)`	現在の値を、指定された関数を現在の値と指定された値に適用した結果で原子的に更新し、前の値を返します。
`int`	`getAndAdd(int delta)`	指定された値を現在の値に原子的に追加します。
`int`	`getAndDecrement()`	現在の値を1だけ原子的に減分します。
`int`	`getAndIncrement()`	現在の値を1だけ原子的に増分します。
`int`	`getAndSet(int newValue)`	指定された値に原子的に設定して、以前の値を返します。
`int`	`getAndUpdate(IntUnaryOperator updateFunction)`	現在の値を、指定された関数を適用した結果で原子的に更新し、前の値を返します。
`int`	`incrementAndGet()`	現在の値を1だけ原子的に増分します。
`int`	`intValue()`	この`AtomicInteger`の値を`int`として返します。
`void`	`lazySet(int newValue)`	指定された値に最終的に設定します。
`long`	`longValue()`	この`AtomicInteger`の拡張プリミティブ変換後の値を`long`として返します。
`void`	`set(int newValue)`	指定された値に設定します。
`String`	`toString()`	現在値の文字列表記を返します。
`int`	`updateAndGet(IntUnaryOperator updateFunction)`	現在の値を、指定された関数を適用した結果で原子的に更新し、更新された値を返します。
`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 - 追加する値
    
    戻り値:
    
    更新された値
  - getAndUpdate
```
public final int getAndUpdate(IntUnaryOperator updateFunction)
```
    現在の値を、指定された関数を適用した結果で原子的に更新し、前の値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。
    
    パラメータ:
    
    updateFunction - 副作用のない関数
    
    戻り値:
    
    前の値
    
    導入されたバージョン:
    
    1.8
  - updateAndGet
```
public final int updateAndGet(IntUnaryOperator updateFunction)
```
    現在の値を、指定された関数を適用した結果で原子的に更新し、更新された値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。
    
    パラメータ:
    
    updateFunction - 副作用のない関数
    
    戻り値:
    
    更新された値
    
    導入されたバージョン:
    
    1.8
  - getAndAccumulate
```
public final int getAndAccumulate(int x,
                                  IntBinaryOperator accumulatorFunction)
```
    現在の値を、指定された関数を現在の値と指定された値に適用した結果で原子的に更新し、前の値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。関数は、現在の値を第1引数とし、指定された更新値を第2引数として適用されます。
    
    パラメータ:
    
    x - 更新値
    
    accumulatorFunction - 2つの引数を取る、副作用のない関数
    
    戻り値:
    
    前の値
    
    導入されたバージョン:
    
    1.8
  - accumulateAndGet
```
public final int accumulateAndGet(int x,
                                  IntBinaryOperator accumulatorFunction)
```
    現在の値を、指定された関数を現在の値と指定された値に適用した結果で原子的に更新し、更新された値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。関数は、現在の値を第1引数とし、指定された更新値を第2引数として適用されます。
    
    パラメータ:
    
    x - 更新値
    
    accumulatorFunction - 2つの引数を取る、副作用のない関数
    
    戻り値:
    
    更新された値
    
    導入されたバージョン:
    
    1.8
  - toString
```
public String toString()
```
    現在値の文字列表記を返します。
    
    オーバーライド:
    
    toString、クラスObject
    
    戻り値:
    
    現在値の文字列表現。
  - intValue
```
public int intValue()
```
    このAtomicIntegerの値をintとして返します。
    
    定義:
    
    intValue、クラスNumber
    
    戻り値:
    
    このオブジェクトが表す数値をint型に変換した値。
  - longValue
```
public long longValue()
```
    このAtomicIntegerの拡張プリミティブ変換後の値をlongとして返します。
    
    定義:
    
    longValue、クラスNumber
    
    戻り値:
    
    このオブジェクトが表す数値をlong型に変換した値。
    
    『Java™言語仕様』を参照してください。
    
    5.1.2 拡張プリミティブ変換
  - floatValue
```
public float floatValue()
```
    このAtomicIntegerの拡張プリミティブ変換後の値をfloatとして返します。
    
    定義:
    
    floatValue、クラスNumber
    
    戻り値:
    
    このオブジェクトが表す数値をfloat型に変換した値。
    
    『Java™言語仕様』を参照してください。
    
    5.1.2 拡張プリミティブ変換
  - doubleValue
```
public double doubleValue()
```
    このAtomicIntegerの拡張プリミティブ変換後の値を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も参照してください。

クラスAtomicInteger

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

メソッドのサマリー

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

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

コンストラクタの詳細

AtomicInteger

AtomicInteger

メソッドの詳細

get

set

lazySet

getAndSet

compareAndSet

weakCompareAndSet

getAndIncrement

getAndDecrement

getAndAdd

incrementAndGet

decrementAndGet

addAndGet

getAndUpdate

updateAndGet

getAndAccumulate

accumulateAndGet

toString

intValue

longValue

floatValue

doubleValue