MathF.Round 方法

  • 参考

定义

命名空间:
System
程序集:
System.Runtime.dll
程序集:
System.Runtime.Extensions.dll
程序集:
netstandard.dll

重载

Round(Single, Int32, MidpointRounding)

使用指定的舍入约定将单精度浮点值舍入到指定数量的小数位数。
Round(Single, MidpointRounding)

使用指定的舍入约定将单精度浮点值舍入到整数。
Round(Single)

将单精度浮点值舍入到最接近的整数值，并将中点值舍入到最接近的偶数。
Round(Single, Int32)

将单精度浮点值舍入到指定的小数位数，并将中点值舍入到最接近的偶数。

Round(Single, Int32, MidpointRounding)

使用指定的舍入约定将单精度浮点值舍入到指定数量的小数位数。

public:
 static float Round(float x, int digits, MidpointRounding mode);
public static float Round (float x, int digits, MidpointRounding mode);
static member Round : single * int * MidpointRounding -> single
Public Shared Function Round (x As Single, digits As Integer, mode As MidpointRounding) As Single

参数

x
Single

要舍入的单精度浮点数。

digits
Int32

返回值中的小数数字。

mode
MidpointRounding

指定要使用的舍入策略的枚举值之一。

返回

Single

舍入为具有digits小数位数的数字x。 如果 x 比 digits 少部分数字，x 原样返回。

例外

ArgumentOutOfRangeException

digits 小于 0 或大于 6。

ArgumentException

mode 不是 MidpointRounding 的一个有效值。

注解

参数的值 digits 范围可以是 0 到 6。 类型支持 Single 的最大整数和小数位数为 6。

重要

在舍入中点值时，舍入算法执行相等测试。 由于浮点格式存在的二进制表示和精度问题，因此方法返回的值可能异常。 有关详细信息，请参阅舍入 和精度。

如果参数的值 x 为 Single.NaN，则该方法返回 Single.NaN。 如果 x 为 Single.PositiveInfinity 或 Single.NegativeInfinity，则该方法分别返回 Single.PositiveInfinity 或 Single.NegativeInfinity返回。

另请参阅

适用于

Round(Single, MidpointRounding)

使用指定的舍入约定将单精度浮点值舍入到整数。

public:
 static float Round(float x, MidpointRounding mode);
public static float Round (float x, MidpointRounding mode);
static member Round : single * MidpointRounding -> single
Public Shared Function Round (x As Single, mode As MidpointRounding) As Single

参数

x
Single

要舍入的单精度浮点数。

mode
MidpointRounding

指定要使用的舍入策略的枚举值之一。

返回

Single

舍入为使用舍入约定的mode整数x。 此方法返回一个 Single 而不是整型类型。

例外

ArgumentException

mode 不是 MidpointRounding 的一个有效值。

注解

重要

在舍入中点值时，舍入算法执行相等测试。 由于浮点格式存在的二进制表示和精度问题，因此方法返回的值可能异常。 有关详细信息，请参阅舍入 和精度。

如果参数的值 x 为 Single.NaN，则该方法返回 Single.NaN。 如果 x 为 Single.PositiveInfinity 或 Single.NegativeInfinity，则该方法分别返回 Single.PositiveInfinity 或 Single.NegativeInfinity返回。

另请参阅

适用于

Round(Single)

将单精度浮点值舍入到最接近的整数值，并将中点值舍入到最接近的偶数。

public:
 static float Round(float x);
public static float Round (float x);
static member Round : single -> single
Public Shared Function Round (x As Single) As Single

参数

x
Single

要舍入的单精度浮点数。

返回

Single

最接近 x 的整数。 如果 x 的小数部分正好处于两个整数中间，其中一个整数为偶数，另一个整数为奇数，则返回偶数。 请注意，此方法返回 Single，而不是整数类型。

注解

此方法使用默认舍入约定 MidpointRounding.ToEven。

重要

在舍入中点值时，舍入算法执行相等测试。 由于浮点格式存在的二进制表示和精度问题，因此方法返回的值可能异常。 有关详细信息，请参阅舍入 和精度。

如果参数的值 x 为 Single.NaN，则该方法返回 Single.NaN。 如果 x 为 Single.PositiveInfinity 或 Single.NegativeInfinity，则该方法分别返回 Single.PositiveInfinity 或 Single.NegativeInfinity返回。

调用方说明

由于精度丢失，因此，由于将小数值表示为浮点数或对浮点值执行算术运算，在某些情况下，该方法 Round(Single) 可能不会将中点值舍入到最接近的偶数整数。

另请参阅

适用于

Round(Single, Int32)

将单精度浮点值舍入到指定的小数位数，并将中点值舍入到最接近的偶数。

public:
 static float Round(float x, int digits);
public static float Round (float x, int digits);
static member Round : single * int -> single
Public Shared Function Round (x As Single, digits As Integer) As Single

参数

x
Single

要舍入的单精度浮点数。

digits
Int32

返回值中的小数数字。

返回

Single

最接近 x 的 digits 位小数的数字。

例外

ArgumentOutOfRangeException

digits 小于 0 或大于 6。

注解

参数的值 digits 范围可以是 0 到 6。 请注意，6 是类型支持 Single 的最大整数和小数位数。

此方法使用默认舍入约定 MidpointRounding.ToEven。

重要

在舍入中点值时，舍入算法执行相等测试。 由于浮点格式存在的二进制表示和精度问题，因此方法返回的值可能异常。 有关详细信息，请参阅舍入 和精度。

如果参数的值 x 为 Single.NaN，则该方法返回 Single.NaN。 如果 x 为 Single.PositiveInfinity 或 Single.NegativeInfinity，则该方法分别返回 Single.PositiveInfinity 或 Single.NegativeInfinity返回。

另请参阅

适用于