RoundingMode 类

定义

命名空间:

Java.Math

程序集:

Mono.Android.dll

为能够放弃精度的数字操作指定 舍入策略 。

[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

继承

Object

JavaObject

Object

Enum

RoundingMode

属性

RegisterAttribute

注解

为能够放弃精度的数字操作指定 舍入策略 。 每个舍入模式指示如何计算舍入结果中返回的最小有效数字。 如果返回的数字数少于表示确切数字结果所需的数字，则丢弃的数字将称为 丢弃的小数， 而不管数字对数字的值的贡献如何。 换句话说，被视为数值，丢弃的分数的绝对值可能大于 1。

每个舍入模式说明都包含一个表，其中列出了不同两位十进制值在有问题的舍入模式下如何舍入为一位数字十进制值。 可以通过创建 BigDecimal 具有指定值的数字，形成 MathContext 具有适当设置的对象（precision 设置为 1该对象并 roundingMode 设置为有问题的舍入模式），并调用 BigDecimal#round round 具有正确 MathContext值的数值，从而获取表中的结果列。 显示所有舍入模式的这些舍入操作结果的摘要表如下所示。

<table class=“striped”>caption b Summary of Rounding Operations Under Different Rounding Mode</b></caption><thead><>tr<th scope=“col” rowspan=“2”>Input Number</th><scope=“col”col“colspan=8>Result of rounding input to one digit with the given rounding mode</th><>tr style=”vertical-align：top“<>th/<><>UP<><>DOWN<><>CEILING<><th>FLOOR</><>HALF_UP<th/><>HALF_DOWN<><>HALF_EVEN<th/th/><>UNNECESSARY<th/th/thead><>< tbody style=“text-align：right”>

<tr><th scope=“row”>5.5</th><td>6</td><td>5</td td>6</td><td>5</td><td 6>/td<>td 5/td td<>5</t><td><td>6</td td>throw <>/tdArithmeticException<><tr><th scope=“row”>2.5</th><td>3</td td>2/td<>td 3</td><><>td<2/><td td 3>/td<><td>2/td<>td td 2<>/td<>td<>throw<> /tdArithmeticException<tr>th scope=“row”<1.6></th><td>2</td td>1</><><><><><>td<>td 2/td td 2</><>td td 2/td 2<>/<><td><>throw <>/tdArithmeticException<><tr><th scope=“row”>1.1</th><td>2</td><td>1</td><>td 2</><td td>1/td<>td<> 1</td td 1/><><><td td>1<><>/td td throw ArithmeticException</td><tr><th scope=“row”>1.0</th><td 1>/td<><td td>1</td><td>1</><td td>1</><td><>td<1>/td td<1>/td<>td 1/td td td<1></td><><tr><th scope=“row”>-1.0</th><> td td-1<>/<><td td-1>/<><><>td td td-1/td<>td-1<></td><td-1/td td-1><><>/<>td<>td< tr>th scope=“row”<-1.1></th><td-2></td td td-1></td><><> td td-1<><>/td td td-2</><>td td-1</><>td td td-1<>/<><td><> throw<> /ArithmeticExceptiontd<><tr><th scope=“row”>-1.6</th><td-2>/td<>td-1<>/td<>< td-1></td><td-2></td><> td td-2</><><><td td td-2></><>td throw ArithmeticException</td><tr><th scope=“row”>-2.5</th><td-3></td t><>-2</td><td-2></td><td-3><>/td<><>< td td-2>/td td-2<></td><><>throwArithmeticException< /td><tr><th scope=“row”>-5.5</th><td-6></><td td td-5>/<><td td td-5></td td-6>/td<><><td-6/td><td-5>/td<>< td-6></td><td>throw <>/tdArithmeticException</tbody></table><>

这enum旨在替换（BigDecimal等BigDecimal#ROUND_UP）中BigDecimal#ROUND_DOWN舍入模式常量的基于整数的枚举。

在 1.5 中添加。

Java文档java.math.RoundingMode。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。

属性

名称	说明
Ceiling	舍入模式以向正无穷大舍入。
Class	返回此 Object的运行时类。 (继承自 Object)
DeclaringClass	返回与此枚举常量枚举类型对应的 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	舍入模式，其中舍入运算为需要舍入的情况引发算术Exception，即对于无法精确表示值的事例。
Up	正值舍入为正无穷大，负值向负无穷大舍入的舍入模式。

方法

名称	说明
Clone()	引发 CloneNotSupportedException。 (继承自 Enum)
CompareTo(Object)	将此枚举与指定对象的顺序进行比较。 (继承自 Enum)
Construct(JniObjectReference, JniObjectReferenceOptions)	为能够放弃精度的数字操作指定 舍入策略 。 (继承自 JavaObject)
Dispose()	释放此Java对等方持有的资源。 (继承自 Object)
Dispose(Boolean)	释放此Java对等方持有的资源。 (继承自 Object)
DisposeUnlessReferenced()	为能够放弃精度的数字操作指定 舍入策略 。 (继承自 JavaObject)
Equals(Object)	为能够放弃精度的数字操作指定 舍入策略 。 (继承自 JavaObject)
Equals(Object)	如果指定的对象等于此枚举常量，则返回 true。 (继承自 Enum)
GetHashCode()	返回此枚举常量的哈希代码。 (继承自 Enum)
JavaFinalize()	当垃圾回收确定不再引用该对象时，由对象上的垃圾回收器调用。 (继承自 Object)
Name()	返回此枚举常量的名称，与枚举声明中所声明的名称完全相同。 (继承自 Enum)
Notify()	唤醒正在等待此对象的监视器的单个线程。 (继承自 Object)
NotifyAll()	唤醒正在等待此对象的监视器的所有线程。 (继承自 Object)
Ordinal()	返回此枚举常量的序号（其枚举声明中的位置，其中初始常量分配为零序号）。 (继承自 Enum)
SetHandle(IntPtr, JniHandleOwnership)	设置 Handle 属性。 (继承自 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	为能够放弃精度的数字操作指定 舍入策略 。 (继承自 JavaObject)
ToArray<T>()	从此Java数组包装器创建托管数组。 (继承自 Object)
ToString()	返回对象的字符串表示形式。 (继承自 Object)
UnregisterFromRuntime()	从互操作运行时取消注册此Java对等。 (继承自 Object)
ValueOf(RoundOptions)	返回 RoundingMode 与旧整数舍入模式常量 BigDecimal对应的对象。
ValueOf(String)	返回具有指定名称的枚举常量。
Values()	按声明顺序返回枚举常量。
Wait()	使当前线程等待，直到唤醒它，通常是通过 em 通知/em< 或 >em<interrupted>/em<。><> (继承自 Object)
Wait(Int64, Int32)	使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted>/em<>，或直到经过一定数量的实时。 (继承自 Object)
Wait(Int64)	使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted>/em<>，或直到经过一定数量的实时。 (继承自 Object)

显式接口实现

名称	说明
IJavaPeerable.Disposed()	为能够放弃精度的数字操作指定 舍入策略 。 (继承自 JavaObject)
IJavaPeerable.Finalized()	为能够放弃精度的数字操作指定 舍入策略 。 (继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	为能够放弃精度的数字操作指定 舍入策略 。 (继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	为能够放弃精度的数字操作指定 舍入策略 。 (继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	为能够放弃精度的数字操作指定 舍入策略 。 (继承自 JavaObject)

扩展方法

名称	说明
GetJniTypeName(IJavaPeerable)	获取实例 self类型的 JNI 名称。
JavaAs<TResult>(IJavaPeerable)	尝试强制self键入TResult，检查强制是否在Java端有效。
JavaCast<TResult>(IJavaObject)	执行 Android 运行时检查的类型转换。
JavaCast<TResult>(IJavaObject)	为能够放弃精度的数字操作指定 舍入策略 。
TryJavaCast<TResult>(IJavaPeerable, TResult)	尝试强制self键入TResult，检查强制是否在Java端有效。