AtomicIntegerArray (Java Platform SE 8)

java.lang.Object
- java.util.concurrent.atomic.AtomicIntegerArray

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

Serializable
```
public class AtomicIntegerArray
extends Object
implements Serializable
```
要素の原子的な更新が可能なint配列です。原子変数のプロパティの詳細は、java.util.concurrent.atomicパッケージ仕様を参照してください。

導入されたバージョン:

1.5

関連項目:

直列化された形式

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

コンストラクタ
コンストラクタ	説明
`AtomicIntegerArray(int length)`	指定された長さの新しいAtomicIntegerArrayを作成し、すべての要素はゼロに初期化されます。
`AtomicIntegerArray(int[] array)`	指定された配列と同じ長さのAtomicIntegerArrayを新しく作成します。すべての要素は、指定された配列からコピーされます。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッド	説明
`int`	`accumulateAndGet(int i, int x, IntBinaryOperator accumulatorFunction)`	インデックス`i`にある要素を、指定された関数を現在の値と指定された値に適用した結果で原子的に更新し、更新された値を返します。
`int`	`addAndGet(int i, int delta)`	指定された値をインデックス`i`の要素に原子的に追加します。
`boolean`	`compareAndSet(int i, int expect, int update)`	「現在の値`==`予想される値」である場合、位置`i`の要素を指定された更新済みの値に原子的に設定します。
`int`	`decrementAndGet(int i)`	インデックス`i`の要素を1だけ原子的に減分します。
`int`	`get(int i)`	位置`i`の現在値を取得します。
`int`	`getAndAccumulate(int i, int x, IntBinaryOperator accumulatorFunction)`	インデックス`i`にある要素を、指定された関数を現在の値と指定された値に適用した結果で原子的に更新し、前の値を返します。
`int`	`getAndAdd(int i, int delta)`	指定された値をインデックス`i`の要素に原子的に追加します。
`int`	`getAndDecrement(int i)`	インデックス`i`の要素を1だけ原子的に減分します。
`int`	`getAndIncrement(int i)`	インデックス`i`の要素を1だけ原子的に増分します。
`int`	`getAndSet(int i, int newValue)`	位置`i`の要素を指定された値に原子的に設定して、以前の値を返します。
`int`	`getAndUpdate(int i, IntUnaryOperator updateFunction)`	インデックス`i`にある要素を、指定された関数を適用した結果で原子的に更新し、前の値を返します。
`int`	`incrementAndGet(int i)`	インデックス`i`の要素を1だけ原子的に増分します。
`void`	`lazySet(int i, int newValue)`	位置`i`の要素を指定された値に最終的に設定します。
`int`	`length()`	配列の長さを返します。
`void`	`set(int i, int newValue)`	位置`i`の要素を指定された値に設定します。
`String`	`toString()`	配列の現在値の文字列表現を返します。
`int`	`updateAndGet(int i, IntUnaryOperator updateFunction)`	インデックス`i`にある要素を、指定された関数を適用した結果で原子的に更新し、更新された値を返します。
`boolean`	`weakCompareAndSet(int i, int expect, int update)`	「現在の値`==`予想される値」である場合、位置`i`の要素を指定された更新済みの値に原子的に設定します。

クラス java.lang.Objectから継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- コンストラクタの詳細
  - AtomicIntegerArray
```
public AtomicIntegerArray(int length)
```
    指定された長さの新しいAtomicIntegerArrayを作成し、すべての要素はゼロに初期化されます。
    
    パラメータ:
    
    length - 配列の長さ
  - AtomicIntegerArray
```
public AtomicIntegerArray(int[] array)
```
    指定された配列と同じ長さのAtomicIntegerArrayを新しく作成します。すべての要素は、指定された配列からコピーされます。
    
    パラメータ:
    
    array - 要素のコピー元の配列
    
    例外:
    
    NullPointerException - 配列がnullの場合
- メソッドの詳細
  - length
```
public final int length()
```
    配列の長さを返します。
    
    戻り値:
    
    arrayの長さ
  - get
```
public final int get(int i)
```
    位置iの現在値を取得します。
    
    パラメータ:
    
    i - インデックス
    
    戻り値:
    
    現行値
  - set
```
public final void set(int i,
                      int newValue)
```
    位置iの要素を指定された値に設定します。
    
    パラメータ:
    
    i - インデックス
    
    newValue - 新しい値
  - lazySet
```
public final void lazySet(int i,
                          int newValue)
```
    位置iの要素を指定された値に最終的に設定します。
    
    パラメータ:
    
    i - インデックス
    
    newValue - 新しい値
    
    導入されたバージョン:
    
    1.6
  - getAndSet
```
public final int getAndSet(int i,
                           int newValue)
```
    位置iの要素を指定された値に原子的に設定して、以前の値を返します。
    
    パラメータ:
    
    i - インデックス
    
    newValue - 新しい値
    
    戻り値:
    
    前の値
  - compareAndSet
```
public final boolean compareAndSet(int i,
                                   int expect,
                                   int update)
```
    「現在の値==予想される値」である場合、位置iの要素を指定された更新済みの値に原子的に設定します。
    
    パラメータ:
    
    i - インデックス
    
    expect - 予想される値
    
    update - 新しい値
    
    戻り値:
    
    成功する場合はtrue。 falseは、実際の値が予想される値と等価ではないことを示す。
  - weakCompareAndSet
```
public final boolean weakCompareAndSet(int i,
                                       int expect,
                                       int update)
```
    「現在の値==予想される値」である場合、位置iの要素を指定された更新済みの値に原子的に設定します。
    見かけ上失敗する可能性があり、順序付け保証を提供しないため、compareAndSetの代わりに使用することはほとんどありません。
    
    パラメータ:
    
    i - インデックス
    
    expect - 予想される値
    
    update - 新しい値
    
    戻り値:
    
    成功した場合はtrue
  - getAndIncrement
```
public final int getAndIncrement(int i)
```
    インデックスiの要素を1だけ原子的に増分します。
    
    パラメータ:
    
    i - インデックス
    
    戻り値:
    
    前の値
  - getAndDecrement
```
public final int getAndDecrement(int i)
```
    インデックスiの要素を1だけ原子的に減分します。
    
    パラメータ:
    
    i - インデックス
    
    戻り値:
    
    前の値
  - getAndAdd
```
public final int getAndAdd(int i,
                           int delta)
```
    指定された値をインデックスiの要素に原子的に追加します。
    
    パラメータ:
    
    i - インデックス
    
    delta - 追加する値
    
    戻り値:
    
    前の値
  - incrementAndGet
```
public final int incrementAndGet(int i)
```
    インデックスiの要素を1だけ原子的に増分します。
    
    パラメータ:
    
    i - インデックス
    
    戻り値:
    
    更新された値
  - decrementAndGet
```
public final int decrementAndGet(int i)
```
    インデックスiの要素を1だけ原子的に減分します。
    
    パラメータ:
    
    i - インデックス
    
    戻り値:
    
    更新された値
  - addAndGet
```
public final int addAndGet(int i,
                           int delta)
```
    指定された値をインデックスiの要素に原子的に追加します。
    
    パラメータ:
    
    i - インデックス
    
    delta - 追加する値
    
    戻り値:
    
    更新された値
  - getAndUpdate
```
public final int getAndUpdate(int i,
                              IntUnaryOperator updateFunction)
```
    インデックスiにある要素を、指定された関数を適用した結果で原子的に更新し、前の値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。
    
    パラメータ:
    
    i - インデックス
    
    updateFunction - 副作用のない関数
    
    戻り値:
    
    前の値
    
    導入されたバージョン:
    
    1.8
  - updateAndGet
```
public final int updateAndGet(int i,
                              IntUnaryOperator updateFunction)
```
    インデックスiにある要素を、指定された関数を適用した結果で原子的に更新し、更新された値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。
    
    パラメータ:
    
    i - インデックス
    
    updateFunction - 副作用のない関数
    
    戻り値:
    
    更新された値
    
    導入されたバージョン:
    
    1.8
  - getAndAccumulate
```
public final int getAndAccumulate(int i,
                                  int x,
                                  IntBinaryOperator accumulatorFunction)
```
    インデックスiにある要素を、指定された関数を現在の値と指定された値に適用した結果で原子的に更新し、前の値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。関数は、インデックスiにある現在の値を第1引数とし、指定された更新値を第2引数として適用されます。
    
    パラメータ:
    
    i - インデックス
    
    x - 更新値
    
    accumulatorFunction - 2つの引数を取る、副作用のない関数
    
    戻り値:
    
    前の値
    
    導入されたバージョン:
    
    1.8
  - accumulateAndGet
```
public final int accumulateAndGet(int i,
                                  int x,
                                  IntBinaryOperator accumulatorFunction)
```
    インデックスiにある要素を、指定された関数を現在の値と指定された値に適用した結果で原子的に更新し、更新された値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。関数は、インデックスiにある現在の値を第1引数とし、指定された更新値を第2引数として適用されます。
    
    パラメータ:
    
    i - インデックス
    
    x - 更新値
    
    accumulatorFunction - 2つの引数を取る、副作用のない関数
    
    戻り値:
    
    更新された値
    
    導入されたバージョン:
    
    1.8
  - toString
```
public String toString()
```
    配列の現在値の文字列表現を返します。
    
    オーバーライド:
    
    toString、クラスObject
    
    戻り値:
    
    配列の現在値の文字列表現

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

クラスAtomicIntegerArray

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

メソッドのサマリー

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

コンストラクタの詳細

AtomicIntegerArray

AtomicIntegerArray

メソッドの詳細

length

get

set

lazySet

getAndSet

compareAndSet

weakCompareAndSet

getAndIncrement

getAndDecrement

getAndAdd

incrementAndGet

decrementAndGet

addAndGet

getAndUpdate

updateAndGet

getAndAccumulate

accumulateAndGet

toString