モジュール java.base
パッケージ java.util.concurrent.atomic

クラスAtomicLongArray

  • すべての実装されたインタフェース:
    Serializable
    public class AtomicLongArray
extends Object
implements Serializable
    要素の原子的な更新が可能なlong配列です。 アトミック・アクセスのプロパティの詳細は、VarHandleの仕様を参照してください。
    導入されたバージョン:
    1.5
    関連項目:
    直列化された形式

    • コンストラクタの詳細

      • AtomicLongArray

        public AtomicLongArray​(int length)
        指定された長さの新しいAtomicLongArrayを作成し、すべての要素はゼロに初期化されます。
        パラメータ:
        length - 配列の長さ

      • AtomicLongArray

        public AtomicLongArray​(long[] array)
        指定された配列と同じ長さのAtomicLongArrayを新しく作成します。すべての要素は、指定された配列からコピーされます。
        パラメータ:
        array - 要素のコピー元の配列
        例外:
        NullPointerException - 配列がnullの場合

    • メソッドの詳細

      • length

        public final int length()
        配列の長さを返します。
        戻り値:
        配列の長さ

      • get

        public final long get​(int i)
        VarHandle.getVolatile(java.lang.Object...)で指定されたメモリー効果を使用して、索引iの要素の現在の値を返します。
        パラメータ:
        i - インデックス
        戻り値:
        現行値

      • set

        public final void set​(int i,
                      long newValue)
        VarHandle.setVolatile(java.lang.Object...)で指定されたメモリー効果を使用して、索引iの要素をnewValueに設定します。
        パラメータ:
        i - インデックス
        newValue - 新しい値

      • lazySet

        public final void lazySet​(int i,
                          long newValue)
        VarHandle.setRelease(java.lang.Object...)で指定されたメモリー効果を使用して、索引iの要素をnewValueに設定します。
        パラメータ:
        i - インデックス
        newValue - 新しい値
        導入されたバージョン:
        1.6

      • getAndSet

        public final long getAndSet​(int i,
                            long newValue)
        索引iの要素を原子的に newValueに設定し、VarHandle.getAndSet(java.lang.Object...)で指定されたメモリー効果を使用して古い値を返します。
        パラメータ:
        i - インデックス
        newValue - 新しい値
        戻り値:
        前の値

      • compareAndSet

        public final boolean compareAndSet​(int i,
                                   long expectedValue,
                                   long newValue)
        VarHandle.compareAndSet(java.lang.Object...)で指定されたメモリー効果を使用して、要素の現在の値== expectedValueの場合、索引iの要素をnewValueに原子的に設定します。
        パラメータ:
        i - インデックス
        expectedValue - 必要な値
        newValue - 新しい値
        戻り値:
        成功する場合はtrue。 falseは、実際の値が予想される値と等価ではないことを示す。

      • weakCompareAndSetPlain

        public final boolean weakCompareAndSetPlain​(int i,
                                            long expectedValue,
                                            long newValue)
        要素の現在の値== expectedValueがVarHandle.weakCompareAndSetPlain(java.lang.Object...)で指定されたメモリー効果を持つ場合、索引iの要素を原子的にnewValueに設定します。
        パラメータ:
        i - インデックス
        expectedValue - 必要な値
        newValue - 新しい値
        戻り値:
        成功した場合はtrue
        導入されたバージョン:
        9

      • getAndIncrement

        public final long getAndIncrement​(int i)
        VarHandle.getAndAdd(java.lang.Object...)で指定されたメモリー効果を使用して、索引iの要素の値を原子的に増分します。

        getAndAdd(i, 1)と同等です。

        パラメータ:
        i - インデックス
        戻り値:
        前の値

      • getAndDecrement

        public final long getAndDecrement​(int i)
        VarHandle.getAndAdd(java.lang.Object...)で指定されたメモリー効果を使用して、索引iの要素の値を原子的に減らします。

        getAndAdd(i, -1)と同等です。

        パラメータ:
        i - インデックス
        戻り値:
        前の値

      • getAndAdd

        public final long getAndAdd​(int i,
                            long delta)
        VarHandle.getAndAdd(java.lang.Object...)で指定されたメモリー効果を使用して、指定された値を索引iの要素に原子的に追加します。
        パラメータ:
        i - インデックス
        delta - 追加する値
        戻り値:
        前の値

      • incrementAndGet

        public final long incrementAndGet​(int i)
        VarHandle.getAndAdd(java.lang.Object...)で指定されたメモリー効果を使用して、索引iの要素の値を原子的に増分します。

        addAndGet(i, 1)と同等です。

        パラメータ:
        i - インデックス
        戻り値:
        更新された値

      • decrementAndGet

        public final long decrementAndGet​(int i)
        VarHandle.getAndAdd(java.lang.Object...)で指定されたメモリー効果を使用して、索引iの要素の値を原子的に減らします。

        addAndGet(i, -1)と同等です。

        パラメータ:
        i - インデックス
        戻り値:
        更新された値

      • addAndGet

        public long addAndGet​(int i,
                      long delta)
        VarHandle.getAndAdd(java.lang.Object...)で指定されたメモリー効果を使用して、指定された値を索引iの要素に原子的に追加します。
        パラメータ:
        i - インデックス
        delta - 追加する値
        戻り値:
        更新された値

      • getAndUpdate

        public final long getAndUpdate​(int i,
                               LongUnaryOperator updateFunction)
        VarHandle.compareAndSet(java.lang.Object...)で指定されたメモリー効果を使用して、索引iの要素を、指定されたファンクションを適用した結果で原子的に更新し、前の値を返します。 関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。
        パラメータ:
        i - インデックス
        updateFunction - 副作用のない関数
        戻り値:
        前の値
        導入されたバージョン:
        1.8

      • updateAndGet

        public final long updateAndGet​(int i,
                               LongUnaryOperator updateFunction)
        (VarHandle.compareAndSet(java.lang.Object...)で指定されたメモリー効果を使用して)索引iの要素を、指定されたファンクションを適用した結果で原子的に更新し、更新された値を返します。 関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。
        パラメータ:
        i - インデックス
        updateFunction - 副作用のない関数
        戻り値:
        更新された値
        導入されたバージョン:
        1.8

      • getAndAccumulate

        public final long getAndAccumulate​(int i,
                                   long x,
                                   LongBinaryOperator accumulatorFunction)
        索引iの要素を(VarHandle.compareAndSet(java.lang.Object...)で指定されたメモリー効果で)アトミックに更新し、指定された関数を現在の値および指定された値に適用して前の値を返します。 関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。 この関数は、索引iの要素の現在の値を最初の引数として適用し、指定された更新を2番目の引数として適用します。
        パラメータ:
        i - インデックス
        x - 更新値
        accumulatorFunction - 2つの引数を取る、副作用のない関数
        戻り値:
        前の値
        導入されたバージョン:
        1.8

      • accumulateAndGet

        public final long accumulateAndGet​(int i,
                                   long x,
                                   LongBinaryOperator accumulatorFunction)
        索引iの要素を(VarHandle.compareAndSet(java.lang.Object...)で指定されたメモリー効果で)アトミックに更新し、指定された関数を現在の値および指定された値に適用して、更新された値を返します。 関数は、試行した更新がスレッド間の競合のため失敗したときに再度適用される可能性があるため、副作用を持つべきではありません。 この関数は、索引iの要素の現在の値を最初の引数として適用し、指定された更新を2番目の引数として適用します。
        パラメータ:
        i - インデックス
        x - 更新値
        accumulatorFunction - 2つの引数を取る、副作用のない関数
        戻り値:
        更新された値
        導入されたバージョン:
        1.8

      • toString

        public String toString()
        配列の現在値の文字列表現を返します。
        オーバーライド:
        toString、クラスObject
        戻り値:
        配列の現在値の文字列表現

      • getPlain

        public final long getPlain​(int i)
        変数が非volatileとして宣言されたかのように、読取りのメモリー・セマンティクスを使用して、索引iの要素の現在の値を戻します。
        パラメータ:
        i - インデックス
        戻り値:
        値
        導入されたバージョン:
        9

      • setPlain

        public final void setPlain​(int i,
                           long newValue)
        索引iの要素をnewValueに設定し、変数が非volatileおよび非finalとして宣言されたかのように、メモリー・セマンティクスを設定します。
        パラメータ:
        i - インデックス
        newValue - 新しい値
        導入されたバージョン:
        9

      • getOpaque

        public final long getOpaque​(int i)
        VarHandle.getOpaque(java.lang.Object...)で指定されたメモリー効果を使用して、索引iの要素の現在の値を返します。
        パラメータ:
        i - インデックス
        戻り値:
        値
        導入されたバージョン:
        9

      • setOpaque

        public final void setOpaque​(int i,
                            long newValue)
        VarHandle.setOpaque(java.lang.Object...)で指定されたメモリー効果を使用して、索引iの要素をnewValueに設定します。
        パラメータ:
        i - インデックス
        newValue - 新しい値
        導入されたバージョン:
        9

      • getAcquire

        public final long getAcquire​(int i)
        VarHandle.getAcquire(java.lang.Object...)で指定されたメモリー効果を使用して、索引iの要素の現在の値を返します。
        パラメータ:
        i - インデックス
        戻り値:
        値
        導入されたバージョン:
        9

      • setRelease

        public final void setRelease​(int i,
                             long newValue)
        VarHandle.setRelease(java.lang.Object...)で指定されたメモリー効果を使用して、索引iの要素をnewValueに設定します。
        パラメータ:
        i - インデックス
        newValue - 新しい値
        導入されたバージョン:
        9

      • compareAndExchange

        public final long compareAndExchange​(int i,
                                     long expectedValue,
                                     long newValue)
        witness value (== expectedValue)と呼ばれる要素の現在の値が、VarHandle.compareAndExchange(java.lang.Object...)で指定されたメモリー効果を持つ場合に、索引iの要素をnewValueに原子的に設定します。
        パラメータ:
        i - インデックス
        expectedValue - 必要な値
        newValue - 新しい値
        戻り値:
        成功した場合の期待値と同じ証人値
        導入されたバージョン:
        9

      • compareAndExchangeAcquire

        public final long compareAndExchangeAcquire​(int i,
                                            long expectedValue,
                                            long newValue)
        witness value (== expectedValue)と呼ばれる要素の現在の値が、VarHandle.compareAndExchangeAcquire(java.lang.Object...)で指定されたメモリー効果を持つ場合に、索引iの要素をnewValueに原子的に設定します。
        パラメータ:
        i - インデックス
        expectedValue - 必要な値
        newValue - 新しい値
        戻り値:
        成功した場合の期待値と同じ証人値
        導入されたバージョン:
        9

      • compareAndExchangeRelease

        public final long compareAndExchangeRelease​(int i,
                                            long expectedValue,
                                            long newValue)
        witness value (== expectedValue)と呼ばれる要素の現在の値が、VarHandle.compareAndExchangeRelease(java.lang.Object...)で指定されたメモリー効果を持つ場合に、索引iの要素をnewValueに原子的に設定します。
        パラメータ:
        i - インデックス
        expectedValue - 必要な値
        newValue - 新しい値
        戻り値:
        成功した場合の期待値と同じ証人値
        導入されたバージョン:
        9

      • weakCompareAndSetVolatile

        public final boolean weakCompareAndSetVolatile​(int i,
                                               long expectedValue,
                                               long newValue)
        要素の現在の値== expectedValueがVarHandle.weakCompareAndSet(java.lang.Object...)で指定されたメモリー効果を持つ場合、索引iの要素を原子的にnewValueに設定します。
        パラメータ:
        i - インデックス
        expectedValue - 必要な値
        newValue - 新しい値
        戻り値:
        成功した場合はtrue
        導入されたバージョン:
        9

      • weakCompareAndSetAcquire

        public final boolean weakCompareAndSetAcquire​(int i,
                                              long expectedValue,
                                              long newValue)
        要素の現在の値== expectedValueがVarHandle.weakCompareAndSetAcquire(java.lang.Object...)で指定されたメモリー効果を持つ場合、索引iの要素を原子的にnewValueに設定します。
        パラメータ:
        i - インデックス
        expectedValue - 必要な値
        newValue - 新しい値
        戻り値:
        成功した場合はtrue
        導入されたバージョン:
        9

      • weakCompareAndSetRelease

        public final boolean weakCompareAndSetRelease​(int i,
                                              long expectedValue,
                                              long newValue)
        要素の現在の値== expectedValueがVarHandle.weakCompareAndSetRelease(java.lang.Object...)で指定されたメモリー効果を持つ場合、索引iの要素を原子的にnewValueに設定します。
        パラメータ:
        i - インデックス
        expectedValue - 必要な値
        newValue - 新しい値
        戻り値:
        成功した場合はtrue
        導入されたバージョン:
        9