compact1、compact2、compact3

java.util.concurrent.atomic

クラスAtomicReferenceArray<E>

java.lang.Object

java.util.concurrent.atomic.AtomicReferenceArray<E>

型パラメータ:

E - この配列に保持されている要素の基底クラス

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

Serializable

public class AtomicReferenceArray<E>
extends Object
implements Serializable

要素を原子的に更新可能なオブジェクト参照の配列です。原子変数のプロパティの詳細は、java.util.concurrent.atomicパッケージ仕様を参照してください。

導入されたバージョン:

1.5

関連項目:

直列化された形式

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

コンストラクタ

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

メソッドのサマリー

修飾子と型	メソッドと説明
E	accumulateAndGet(int i, E x, BinaryOperator<E> accumulatorFunction) インデックスiにある要素を、指定された関数を現在の値と指定された値に適用した結果で原子的に更新し、更新された値を返します。
boolean	compareAndSet(int i, E expect, E update) 「現在の値==予想される値」である場合、位置iの要素を指定された更新済みの値に原子的に設定します。
E	get(int i) 位置iの現在値を取得します。
E	getAndAccumulate(int i, E x, BinaryOperator<E> accumulatorFunction) インデックスiにある要素を、指定された関数を現在の値と指定された値に適用した結果で原子的に更新し、前の値を返します。
E	getAndSet(int i, E newValue) 位置iの要素を指定された値に原子的に設定して、以前の値を返します。
E	getAndUpdate(int i, UnaryOperator<E> updateFunction) インデックスiにある要素を、指定された関数を適用した結果で原子的に更新し、前の値を返します。
void	lazySet(int i, E newValue) 位置iの要素を指定された値に最終的に設定します。
int	length() 配列の長さを返します。
void	set(int i, E newValue) 位置iの要素を指定された値に設定します。
String	toString() 配列の現在値の文字列表現を返します。
E	updateAndGet(int i, UnaryOperator<E> updateFunction) インデックスiにある要素を、指定された関数を適用した結果で原子的に更新し、更新された値を返します。
boolean	weakCompareAndSet(int i, E expect, E update) 「現在の値==予想される値」である場合、位置iの要素を指定された更新済みの値に原子的に設定します。

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

AtomicReferenceArray

public AtomicReferenceArray(int length)

指定された長さの新しいAtomicReferenceArrayを作成し、すべての要素はゼロに初期化されます。

パラメータ:

length - 配列の長さ

AtomicReferenceArray

public AtomicReferenceArray(E[] array)

指定された配列と同じ長さのAtomicReferenceArrayを新しく作成します。すべての要素は、指定された配列からコピーされます。

パラメータ:

array - 要素のコピー元の配列

例外:

NullPointerException - 配列がnullの場合

メソッドの詳細

length

public final int length()

配列の長さを返します。

戻り値:

arrayの長さ

get

public final E get(int i)

位置iの現在値を取得します。

パラメータ:

i - インデックス

戻り値:

現行値

set

public final void set(int i,
                      E newValue)

位置iの要素を指定された値に設定します。

パラメータ:

i - インデックス

newValue - 新しい値

lazySet

public final void lazySet(int i,
                          E newValue)

位置iの要素を指定された値に最終的に設定します。

パラメータ:

i - インデックス

newValue - 新しい値

導入されたバージョン:

1.6

getAndSet

public final E getAndSet(int i,
                         E newValue)

位置iの要素を指定された値に原子的に設定して、以前の値を返します。

パラメータ:

i - インデックス

newValue - 新しい値

戻り値:

前の値

compareAndSet

public final boolean compareAndSet(int i,
                                   E expect,
                                   E update)

「現在の値==予想される値」である場合、位置iの要素を指定された更新済みの値に原子的に設定します。

パラメータ:

i - インデックス

expect - 予想される値

update - 新しい値

戻り値:

成功する場合はtrue。falseは、実際の値が予想される値と等価ではないことを示す。

weakCompareAndSet

public final boolean weakCompareAndSet(int i,
                                       E expect,
                                       E update)

「現在の値==予想される値」である場合、位置iの要素を指定された更新済みの値に原子的に設定します。

見かけ上失敗する可能性があり、順序付け保証を提供しないため、compareAndSetの代わりに使用することはほとんどありません。

パラメータ:

i - インデックス

expect - 予想される値

update - 新しい値

戻り値:

成功した場合はtrue

getAndUpdate

public final E getAndUpdate(int i,
                            UnaryOperator<E> updateFunction)

インデックスiにある要素を、指定された関数を適用した結果で原子的に更新し、前の値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。

パラメータ:

i - インデックス

updateFunction - 副作用のない関数

戻り値:

前の値

導入されたバージョン:

1.8

updateAndGet

public final E updateAndGet(int i,
                            UnaryOperator<E> updateFunction)

インデックスiにある要素を、指定された関数を適用した結果で原子的に更新し、更新された値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。

パラメータ:

i - インデックス

updateFunction - 副作用のない関数

戻り値:

更新された値

導入されたバージョン:

1.8

getAndAccumulate

public final E getAndAccumulate(int i,
                                E x,
                                BinaryOperator<E> accumulatorFunction)

インデックスiにある要素を、指定された関数を現在の値と指定された値に適用した結果で原子的に更新し、前の値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。関数は、インデックスiにある現在の値を第1引数とし、指定された更新値を第2引数として適用されます。

パラメータ:

i - インデックス

x - 更新値

accumulatorFunction - 2つの引数を取る、副作用のない関数

戻り値:

前の値

導入されたバージョン:

1.8

accumulateAndGet

public final E accumulateAndGet(int i,
                                E x,
                                BinaryOperator<E> accumulatorFunction)

インデックスiにある要素を、指定された関数を現在の値と指定された値に適用した結果で原子的に更新し、更新された値を返します。関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。関数は、インデックスiにある現在の値を第1引数とし、指定された更新値を第2引数として適用されます。

パラメータ:

i - インデックス

x - 更新値

accumulatorFunction - 2つの引数を取る、副作用のない関数

戻り値:

更新された値

導入されたバージョン:

1.8

toString

public String toString()

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

オーバーライド:

toString、クラス: Object

戻り値:

配列の現在値の文字列表現