java.util.concurrent.atomic

クラス AtomicLongArray

java.lang.Object

java.util.concurrent.atomic.AtomicLongArray

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

Serializable

public class AtomicLongArray
extends Object
implements Serializable

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

導入されたバージョン:

1.5

関連項目:

直列化された形式

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

コンストラクタ

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

メソッドのサマリー

メソッド

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

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

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

コンストラクタの詳細

AtomicLongArray

public AtomicLongArray(int length)

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

パラメータ:

length - 配列の長さ

AtomicLongArray

public AtomicLongArray(long[] array)

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

パラメータ:

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

例外:

NullPointerException - 配列が null の場合

メソッドの詳細

length

public final int length()

配列の長さを返します。

戻り値:

array の長さ

get

public final long get(int i)

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

パラメータ:

i - インデックス

戻り値:

現行値

set

public final void set(int i,
       long newValue)

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

パラメータ:

i - インデックス

newValue - 新しい値

lazySet

public final void lazySet(int i,
           long newValue)

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

パラメータ:

i - インデックス

newValue - 新しい値

導入されたバージョン:

1.6

getAndSet

public final long getAndSet(int i,
             long newValue)

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

パラメータ:

i - インデックス

newValue - 新しい値

戻り値:

前の値

compareAndSet

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

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

パラメータ:

i - インデックス

expect - 予想される値

update - 新しい値

戻り値:

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

weakCompareAndSet

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

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

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

パラメータ:

i - インデックス

expect - 予想される値

update - 新しい値

戻り値:

成功する場合は true。

getAndIncrement

public final long getAndIncrement(int i)

インデックス i の要素を 1 だけ原子的に増分します。

パラメータ:

i - インデックス

戻り値:

前の値

getAndDecrement

public final long getAndDecrement(int i)

インデックス i の要素を 1 だけ原子的に減分します。

パラメータ:

i - インデックス

戻り値:

前の値

getAndAdd

public final long getAndAdd(int i,
             long delta)

指定された値をインデックス i の要素に原子的に追加します。

パラメータ:

i - インデックス

delta - 追加する値

戻り値:

前の値

incrementAndGet

public final long incrementAndGet(int i)

インデックス i の要素を 1 だけ原子的に増分します。

パラメータ:

i - インデックス

戻り値:

更新された値

decrementAndGet

public final long decrementAndGet(int i)

インデックス i の要素を 1 だけ原子的に減分します。

パラメータ:

i - インデックス

戻り値:

更新された値

addAndGet

public long addAndGet(int i,
             long delta)

指定された値をインデックス i の要素に原子的に追加します。

パラメータ:

i - インデックス

delta - 追加する値

戻り値:

更新された値

toString

public String toString()

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

オーバーライド:

toString、クラス: Object

戻り値:

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