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

使用 mode 舍入约定 digits 小数位数的 x 的舍入表示形式

例外

ArgumentOutOfRangeException

digits 小于 0 或大于 6。

ArgumentException

mode 不是 MidpointRounding的有效值。

注解

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

重要

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

如果 Single.NaNx 参数的值，该方法将返回 Single.NaN。 如果 xSingle.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 的舍入表示形式

例外

ArgumentException

mode 不是 MidpointRounding的有效值。

注解

重要

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

如果 Single.NaNx 参数的值，该方法将返回 Single.NaN。 如果 xSingle.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 的舍入表示形式

注解

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

重要

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

如果 Single.NaNx 参数的值，该方法将返回 Single.NaN。 如果 xSingle.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

带 digits 小数位数的 x 的舍入表示形式

例外

ArgumentOutOfRangeException

digits 小于 0 或大于 6。

注解

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

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

重要

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

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

另请参阅

• Ceiling(Single)
• Floor(Single)