MathF.Round 方法

定義

命名空間:

System

組件:

System.Runtime.dll

套件:

Microsoft.Bcl.Numerics v9.0.0-preview.3.24172.9

多載

Round(Single, Int32, MidpointRounding)	使用指定的四捨五入慣例，將單精確度浮點數四捨五入為指定的小數位數。
Round(Single, MidpointRounding)	使用指定的四捨五入慣例，將單精確度浮點值四捨五入為整數。
Round(Single)	將單精確度浮點數值四捨五入到最接近的整數值，並將中間點值四捨五入到最接近的偶數。
Round(Single, Int32)	將單精確度浮點數值四捨五入到小數數字的指定數字，並將中間點值四捨五入到最接近的偶數。

Round(Single, Int32, MidpointRounding)

來源:

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。

重要

將中間點值捨入時，捨入演算法會執行相等性測試。 因為二進位表示法與浮點數格式的精確度問題，方法可能傳回非預期的值。 如需詳細資訊，請參閱 四捨五入和有效位數。

如果引數的值 x 是 Single.NaN ，則方法會傳 Single.NaN 回 。 如果 為 xSingle.PositiveInfinity 或 Single.NegativeInfinity ，則方法會分別傳 Single.PositiveInfinity 回 或 Single.NegativeInfinity 。

另請參閱

• Ceiling(Single)
• Floor(Single)

Round(Single, MidpointRounding)

來源:

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 值。

備註

重要

將中間點值捨入時，捨入演算法會執行相等性測試。 因為二進位表示法與浮點數格式的精確度問題，方法可能傳回非預期的值。 如需詳細資訊，請參閱 四捨五入和有效位數。

如果引數的值 x 是 Single.NaN ，則方法會傳 Single.NaN 回 。 如果 為 xSingle.PositiveInfinity 或 Single.NegativeInfinity ，則方法會分別傳 Single.PositiveInfinity 回 或 Single.NegativeInfinity 。

另請參閱

• Ceiling(Single)
• Floor(Single)

Round(Single)

來源:

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 。

重要

將中間點值捨入時，捨入演算法會執行相等性測試。 因為二進位表示法與浮點數格式的精確度問題，方法可能傳回非預期的值。 如需詳細資訊，請參閱 四捨五入和有效位數。

如果引數的值 x 是 Single.NaN ，則方法會傳 Single.NaN 回 。 如果 為 xSingle.PositiveInfinity 或 Single.NegativeInfinity ，則方法會分別傳 Single.PositiveInfinity 回 或 Single.NegativeInfinity 。

給呼叫者的注意事項

由於遺失可能因為將十進位值表示為浮點數或對浮點數執行算數運算而造成的精確度遺失，在某些情況下， Round(Single) 方法可能不會將中間點值四捨五入到最接近的偶數整數。

另請參閱

• Ceiling(Single)
• Floor(Single)

Round(Single, Int32)

來源:

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 。

重要

將中間點值捨入時，捨入演算法會執行相等性測試。 因為二進位表示法與浮點數格式的精確度問題，方法可能傳回非預期的值。 如需詳細資訊，請參閱 四捨五入和有效位數。

如果引數的值 x 是 Single.NaN ，則方法會傳 Single.NaN 回 。 如果 為 xSingle.PositiveInfinity 或 Single.NegativeInfinity ，則方法會分別傳 Single.PositiveInfinity 回 或 Single.NegativeInfinity 。

另請參閱

• Ceiling(Single)
• Floor(Single)