MathF.Round 方法

定義

命名空間:

System

組件:

System.Runtime.dll

多載

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

使用 mode 四捨五入慣例 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。

另請參閱

• 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

例外狀況

ArgumentException

mode 不是 MidpointRounding的有效值。

備註

重要

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

如果 x 自變數的值是 Single.NaN，則方法會傳回 Single.NaN。 如果 x 是 Single.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 的四捨五入表示法

備註

這個方法會使用 MidpointRounding.ToEven的預設四捨五入慣例。

重要

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

如果 x 自變數的值是 Single.NaN，則方法會傳回 Single.NaN。 如果 x 是 Single.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

具有 digits 小數位數之 x 的四捨五入表示法

例外狀況

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。

另請參閱

• Ceiling(Single)
• Floor(Single)