RoundingMode 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
規定能捨棄精確度的數值運算的 四捨五入策略 。
[Android.Runtime.Register("java/math/RoundingMode", DoNotGenerateAcw=true)]
public sealed class RoundingMode : Java.Lang.Enum
[<Android.Runtime.Register("java/math/RoundingMode", DoNotGenerateAcw=true)>]
type RoundingMode = class
inherit Enum
- 繼承
- 屬性
備註
規定能捨棄精確度的數值運算的 四捨五入策略 。 每種四捨五入模式都表示如何計算四捨五入結果中回傳的最低有效位。 若回傳的數字少於代表精確數字結果所需的數字,則被捨棄的數字將被稱為 棄置分數 ,無論這些數字對數字值的貢獻如何。 換句話說,若以數值來看,捨棄的分數絕對值可能大於一。
每種四捨五入模式描述都會列出在該四捨五入模式下,不同兩位小數值如何四捨五入為一位數小數值。 表格中的結果欄可透過建立 BigDecimal 指定值的數字,形成 MathContext 一個適當設定的物件(precision 設 1為 ,且 roundingMode 設為該四捨五入模式),並以 BigDecimal#round round 適當的 MathContext呼叫該數字 來得到。 以下為一份總結表,顯示所有捨入模式的四捨五入運算結果。
<表格類別=“條紋”>標題 b 不同四捨五入模式<下的四捨五入操作摘要/b></caption><thead><tr><th scope=“col” rowspan=“2”>輸入數字</th><scope =“col”colspan=8>將<輸入四捨五入為一位數字的結果/th<>tr style=“vertical-align:top”<>th<>UP/th th<>DOWN/th<>th/th th><CEILING/th><>><<><thFLOOR<>/th><th>HALF_UP</th<>thHALF_DOWN></th th/th<>th/th<UNNECESSARY><> th><HALF_EVEN/th/<>thead><tbody style=“text-align:right”>
<TR><th scope=“row”5.5></th<>TD>6</TDD<>TDD>5</TDD><>TDD 6</TDD<>TDD>5</TDD<>TDD 6/TDD TDD>6</TDD<>TDD<> 5/TDD<>>< TD 6/TD>><throw ArithmeticException</td><tr><scope =“row”>2.5</th><TDD>3</TDD<>TDD>2</TDD><>3</TDD<>TD>2/<TD><>3</TDD><>TD 2</TDD><>TD 2</TDD>><傳球 /TD 傳><球<ArithmeticException TD /TD<>射門=“row”>1.6</th<>TDD>TD< 2/TDD><TDD>1</TDD<>>TD 2</><TDD TDD>1</TDD<>>TD 2</TDD<>>TD 2</<>>TD<<>> 傳球ArithmeticException</TDtr th scope=“row”1.1></th><TD>2</TDD<>TDD>1</td<>TDD>2</td><td>1</td><td 1/td td>1</td><td<> 1/td><td><>>< td throw ArithmeticException</td<>tr><th scope=“row”>1.0</th><TDD>1</TDD<>TDD><><1/td><TDD>1</td<>TDD>1</td><TDD>1</td<>TDD>1</td TDD 1/td>><<TDD<>> 1</td><tr><TH scope=“row”>-1.0</th><TD-1<>/TDD<<>>TD-1><>/TD TD-1</TD TD-1/TD<>> TD-1/TD TD-1/TD TD-1</TD>><<></td><TD-1></TD-1><></TDD<>TD-1></TD<>TR><TH scope=“row”>-1.1</th><TD-2></TDD<>TD-1<>/TD-1<>>/TDD<>TD-2<<>/TDD<>TD-1>/TDD TD-1</TDD><> TD-1</TD>><<><> 投擲ArithmeticException</TD>TR th scope=“row”>-1.6</th<>td-2></td><td-1></td<>td-1>/td><td-2><</td<>td-2></td<>td-2>/td><td-2><</<>>td TD throw ArithmeticException</td><tr><th scope=“row”>-2.5</th<>td-3></td><td><<-2/達陣<>TD-2></TDD<>TD-3></TD<>> TD-3</TDD<>TD-2<>/TDD<>TD-2<>/>><TD 投擲<ArithmeticException /TD><tr><scope =“row”>-5.5</th<>TD-TD-5><<<>>/TD TD-5/TD><TD-5>/TD TD-6>/TD TD-6<><</TD<><>TD-6></TDD<>TD-5></TDD><TD-6></TDD>><傳球<ArithmeticException /TD/<>Tbody></Table(球桌)>
此設計enum旨在取代基於整數的捨入模常數列舉(BigDecimalBigDecimal#ROUND_UP、 BigDecimal#ROUND_DOWN,等)。
已在1.5中新增。
Java 文件 java.math.RoundingMode。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
屬性
| 名稱 | Description |
|---|---|
| Ceiling |
將四捨五入模式轉為向正無限大四捨五入。 |
| Class |
回傳此 |
| DeclaringClass |
回傳對應該 enum 常數的 enum 型別的 Class 物件。 (繼承來源 Enum) |
| Down |
四捨五入模式,將數值四捨五入至零。 |
| Floor |
將四捨五入模式轉為向負無限大四捨五入。 |
| HalfDown |
四捨五入模式,數值向最近鄰四捨五入。 |
| HalfEven |
四捨五入模式,數值向最近鄰四捨五入。 |
| HalfUp |
四捨五入模式,數值向最近鄰四捨五入。 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
取得執行時最後指派的狀態旗標。 (繼承來源 JavaObject) |
| JniPeerMembers |
這類人能獲得JNI同儕會員。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 (繼承來源 Enum) |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構,並非直接從你的程式碼中使用。 (繼承來源 Enum) |
| Unnecessary |
捨入模式中,捨入運算會拋出 ArithmeticException,表示必須捨入,也就是無法精確表示該值的情況。 |
| Up |
四捨五入模式,正值向正無限大四捨五入,負值向負無限大四捨五入。 |
方法
| 名稱 | Description |
|---|---|
| Clone() |
丟出 CloneNotSupportedException。 (繼承來源 Enum) |
| CompareTo(Object) |
將此枚舉與指定的物件比較以取得順序。 (繼承來源 Enum) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
將此對等節點的建置委派給執行時的值管理器。 (繼承來源 JavaObject) |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
請求值管理器處置此對等節點,除非其映射保留該受管理實例。 (繼承來源 JavaObject) |
| Equals(Object) |
測試另一個受管理節點是否參考相同的 Java 物件。 (繼承來源 JavaObject) |
| Equals(Object) |
若指定物件等於此枚舉常數,則回傳為真。 (繼承來源 Enum) |
| GetHashCode() |
回傳此枚舉常數的雜湊碼。 (繼承來源 Enum) |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。 (繼承來源 Object) |
| Name() |
回傳這個枚舉常數的名稱,完全與其枚舉宣告中所宣告的一樣。 (繼承來源 Enum) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| Ordinal() |
回傳此枚舉常數的序數(其在枚舉宣告中的位置,初始常數被賦予序數為零)。 (繼承來源 Enum) |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
在控制區塊中儲存參考值,但不建立 JNI 參考副本。 (繼承來源 JavaObject) |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| ValueOf(RoundOptions) |
回傳 |
| ValueOf(String) |
回傳帶有指定名稱的枚舉常數。 |
| Values() |
以宣告順序回傳列舉常數。 |
| Wait() |
使目前執行緒等待被喚醒,通常是透過 通知 或 中斷。 (繼承來源 Object) |
| Wait(Int64, Int32) |
使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。 (繼承來源 Object) |
| Wait(Int64) |
使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
標記此節點為處置,並以 |
| IJavaPeerable.Finalized() |
標記此節點為處置,並以 |
| IJavaPeerable.JniObjectReferenceControlBlock |
取得此對等端使用的原生控制區塊指標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
儲存執行時提供的身份雜湊碼。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
取代儲存的受管理對等狀態旗標。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
當引用無效時,更新對等節點並釋放已拋棄節點的控制區塊。 (繼承來源 JavaObject) |
| IJavaPeerable.UnregisterFromRuntime() |
將此實例從執行時的 Java 物件查詢中移除。 (繼承來源 Enum) |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
重用相容的受管理對等端或取得請求型態的包裝器。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |