MathF.Round 方法

定义

命名空间:

System

程序集:

System.Runtime.dll

重载

Round(Single, Int32, MidpointRounding)	使用指定的舍入约定将单精度浮点值舍入到指定数量的小数位数。
Round(Single, MidpointRounding)	使用指定的舍入约定将单精度浮点值舍入为整数。
Round(Single)	将单精度浮点值舍入到最接近的整数值，并将中点值舍入到最接近的偶数。
Round(Single, Int32)	将单精度浮点值舍入到指定的小数位数，并将中点值舍入到最接近的偶数。

Round(Single, Int32, MidpointRounding)

Source:

MathF.cs

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

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

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

例外

ArgumentOutOfRangeException

digits 小于 0 或大于 6。

ArgumentException

mode 不是 MidpointRounding 的一个有效值。

注解

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

重要

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

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

另请参阅

• Ceiling(Single)
• Floor(Single)

Round(Single, MidpointRounding)

Source:

MathF.cs

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

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 的一个有效值。

注解

重要

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

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

另请参阅

• Ceiling(Single)
• Floor(Single)

Round(Single)

Source:

MathF.cs

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

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。

重要

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

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

调用方说明

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

另请参阅

• Ceiling(Single)
• Floor(Single)

Round(Single, Int32)

Source:

MathF.cs

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

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。

重要

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

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

另请参阅

• Ceiling(Single)
• Floor(Single)