LongAccumulator 類別

定義

命名空間:

Java.Util.Concurrent.Atomic

組件:

Mono.Android.dll

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

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

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

繼承

Object

JavaObject

Object

Number

LongAccumulator

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable ISerializable IDisposable

備註

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

此類別通常比多個執行緒更新用於統計資料等目的的共同值更為理想，而非 AtomicLong 細緻同步控制。 在低更新競爭情況下，這兩個類別具有相似的特性。 但在高度競爭下，該級別的預期吞吐量顯著較高，但代價是空間消耗較高。

執行緒內部或執行緒間的累積順序無法保證且無法依賴，因此此類別僅適用於累積順序不重要的函數。 所提供的累加器函式應無副作用，因為當嘗試更新因執行緒間爭用失敗時，可重新套用。 為了獲得可預測的結果，累加器函數應具備結合與交換性。 函式以一個現有值（或身份）作為參數，另一個參數為給定的更新。 例如，為了維持一個持續的最大值，你可以將 作為Long::maxLong.MIN_VALUE身份。

LongAdder類別提供了該類別功能的類比，適用於常見的特殊情況——維護計數與和。 該呼叫 new LongAdder() 等價於 new LongAccumulator((x, y) -> x + y, 0L)。

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

新增於1.8版本。

的 java.util.concurrent.atomic.LongAccumulatorJava 檔。

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

建構函式

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

屬性

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

方法

名稱	Description
Accumulate(Int64)	更新時會用給定的數值。
ByteValue()	回傳指定數字的值為 byte。 (繼承來源 Number)
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	一個或多個變數共同維持一個透過所提供函式更新的執行 long 值。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	一個或多個變數共同維持一個透過所提供函式更新的執行 long 值。 (繼承來源 JavaObject)
DoubleValue()	經過擴大的原始轉換後，會回傳 #get 當前值 double 。
Equals(Object)	一個或多個變數共同維持一個透過所提供函式更新的執行 long 值。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
FloatValue()	經過擴大的原始轉換後，會回傳 #get 當前值 float 。
Get()	回傳當前值。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
IntValue()	在原始轉換縮小後，回傳 #get 當前值 int 。
JavaFinalize()	當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
LongValue()	相當於 #get。
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
Reset()	重置變數，維持恆等值的更新。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	一個或多個變數共同維持一個透過所提供函式更新的執行 long 值。 (繼承來源 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()	一個或多個變數共同維持一個透過所提供函式更新的執行 long 值。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	一個或多個變數共同維持一個透過所提供函式更新的執行 long 值。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	一個或多個變數共同維持一個透過所提供函式更新的執行 long 值。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	一個或多個變數共同維持一個透過所提供函式更新的執行 long 值。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	一個或多個變數共同維持一個透過所提供函式更新的執行 long 值。 (繼承來源 JavaObject)

擴充方法

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