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。

方法摘要

boolean	compareAndSet(int i, E expect, E update) 如果當前值 == 預期值，則以原子方式將位置 i 的元素設置為給定的更新值。
E	get(int i) 獲取位置 i 的當前值。
E	getAndSet(int i, E newValue) 以原子方式將位置 i 的元素設置為給定值，並返回舊值。
void	lazySet(int i, E newValue) 最終將位置 i 的元素設置為給定值。
int	length() 返回該陣列的長度。
void	set(int i, E newValue) 將位置 i 的元素設置為給定值。
String	toString() 返回陣列當前值的字元串表示形式。
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()

返回該陣列的長度。

返回：

該陣列的長度

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。

toString

public String toString()

返回陣列當前值的字元串表示形式。

覆寫：

類別 Object 中的 toString

返回：

陣列當前值的字元串表示形式。