DoubleAccumulator 類別

定義

命名空間:: Java.Util.Concurrent.Atomic

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

一個或多個變數共同維持一個透過所提供函式更新的執行 double 值。

[Android.Runtime.Register("java/util/concurrent/atomic/DoubleAccumulator", ApiSince=24, DoNotGenerateAcw=true)]
public class DoubleAccumulator : Java.Lang.Number, IDisposable

[<Android.Runtime.Register("java/util/concurrent/atomic/DoubleAccumulator", ApiSince=24, DoNotGenerateAcw=true)>]
type DoubleAccumulator = class
    inherit Number
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

繼承: Object

JavaObject

Object

Number
DoubleAccumulator

屬性: RegisterAttribute

實作: IJavaObject IJavaPeerable ISerializable IDisposable

備註

一個或多個變數共同維持一個透過所提供函式更新的執行 double 值。當更新（方法 #accumulate）在執行緒間爭用時，變數集合可能會動態增加以減少爭用。方法 #get （或等價地） #doubleValue會回傳當前值，涵蓋維護更新的變數。

當多個執行緒更新一個共同值時，這個類別通常比替代方案更理想，該值用於如摘要統計等頻繁更新但較少讀取的用途。

所提供的累加器函式應無副作用，因為當嘗試更新因執行緒間爭用失敗時，可重新套用。為了達到可預測的結果，累加器函數應在使用情境下所需的浮點容忍範圍內，具有交換性和關聯性。函式以一個現有值（或身份）作為參數，另一個參數為給定的更新。例如，為了維持一個持續的最大值，你可以將作為Double::maxDouble.NEGATIVE_INFINITY身份。累積順序在執行緒內或執行緒間無法保證。因此，若需要數值穩定性，尤其是合併數量級差異顯著的數值時，此類別可能不適用。

DoubleAdder類別提供了該類別功能在維護和的常見特殊情況中的功能類比。該呼叫 new DoubleAdder() 等價於 new DoubleAccumulator((x, y) -> x + y, 0.0)。

此類別擴展 Number，但 em<not>/em< 是否>定義了像 equals、和 hashCodecompareTo 這樣的方法，因為實例預期會被變異，因此不適合作為集合鍵。

新增於1.8版本。

Java 文件 java.util.concurrent.atomic.DoubleAccumulator。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

建構函式

名稱	Description
DoubleAccumulator(IDoubleBinaryOperator, Double)	使用給定的累加器函數和恆等元素建立一個新實例。
DoubleAccumulator(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	一個或多個變數共同維持一個透過所提供函式更新的執行 `double` 值。 (繼承來源 JavaObject)
JniPeerMembers	取得用於調用此 Java 節點成員的 JNI 元資料。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThenReset	等同於， `#get` 接著是 `#reset`。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。

方法

名稱	Description
Accumulate(Double)	更新時會用給定的數值。
ByteValue()	回傳指定數字的值為 `byte`。 (繼承來源 Number)
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	一個或多個變數共同維持一個透過所提供函式更新的執行 `double` 值。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	一個或多個變數共同維持一個透過所提供函式更新的執行 `double` 值。 (繼承來源 JavaObject)
DoubleValue()	相當於 `#get`。
Equals(Object)	一個或多個變數共同維持一個透過所提供函式更新的執行 `double` 值。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
FloatValue()	經過縮窄的原始轉換後，將 #get 當前值回傳為 a `float` 。
Get()	回傳當前值。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
IntValue()	在原始轉換縮小後，回傳 #get 當前值 `int` 。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
LongValue()	經過縮窄的原始轉換後，將 #get 當前值回傳為 a `long` 。
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
Reset()	重置變數，維持恆等值的更新。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	一個或多個變數共同維持一個透過所提供函式更新的執行 `double` 值。 (繼承來源 JavaObject)
ShortValue()	回傳指定數字的值為 `short`。 (繼承來源 Number)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	一個或多個變數共同維持一個透過所提供函式更新的執行 `double` 值。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	一個或多個變數共同維持一個透過所提供函式更新的執行 `double` 值。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	一個或多個變數共同維持一個透過所提供函式更新的執行 `double` 值。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	一個或多個變數共同維持一個透過所提供函式更新的執行 `double` 值。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	一個或多個變數共同維持一個透過所提供函式更新的執行 `double` 值。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	一個或多個變數共同維持一個透過所提供函式更新的執行 `double` 值。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	一個或多個變數共同維持一個透過所提供函式更新的執行 `double` 值。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	一個或多個變數共同維持一個透過所提供函式更新的執行 `double` 值。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於