MathF.Round 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
Round(Single, Int32, MidpointRounding) |
使用指定的四捨五入慣例,將單精確度浮點數四捨五入為指定的小數位數。 |
Round(Single, MidpointRounding) |
使用指定的四捨五入慣例,將單精確度浮點值四捨五入為整數。 |
Round(Single) |
將單精確度浮點數值四捨五入到最接近的整數值,並將中間點值四捨五入到最接近的偶數。 |
Round(Single, Int32) |
將單精確度浮點數值四捨五入到小數數字的指定數字,並將中間點值四捨五入到最接近的偶數。 |
Round(Single, Int32, MidpointRounding)
- 來源:
- MathF.cs
- 來源:
- MathF.cs
- 來源:
- 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
其中一個列舉值,指定要使用的四捨五入策略。
傳回
x
四捨五入為具有 digits
小數位數的數位。 如果 x
的小數位數少於 digits
,x
傳回時不會變更。
例外狀況
digits
小於 0 或大於 6。
mode
不是有效的 MidpointRounding 值。
備註
引數的值 digits
可以介於 0 到 6 之間。 類型所 Single 支援的整數和小數位數上限為 6。
重要
將中間點值捨入時,捨入演算法會執行相等性測試。 因為二進位表示法與浮點數格式的精確度問題,方法可能傳回非預期的值。 如需詳細資訊,請參閱 四捨五入和有效位數。
如果引數的值 x
是 Single.NaN ,則方法會傳 Single.NaN 回 。 如果 為 x
Single.PositiveInfinity 或 Single.NegativeInfinity ,則方法會分別傳 Single.PositiveInfinity 回 或 Single.NegativeInfinity 。
另請參閱
適用於
Round(Single, MidpointRounding)
- 來源:
- MathF.cs
- 來源:
- MathF.cs
- 來源:
- 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
其中一個列舉值,指定要使用的四捨五入策略。
傳回
使用四捨五入慣例四捨五入的 mode
整數 x
。 這個方法會傳 Single 回 ,而不是整數型別。
例外狀況
mode
不是有效的 MidpointRounding 值。
備註
重要
將中間點值捨入時,捨入演算法會執行相等性測試。 因為二進位表示法與浮點數格式的精確度問題,方法可能傳回非預期的值。 如需詳細資訊,請參閱 四捨五入和有效位數。
如果引數的值 x
是 Single.NaN ,則方法會傳 Single.NaN 回 。 如果 為 x
Single.PositiveInfinity 或 Single.NegativeInfinity ,則方法會分別傳 Single.PositiveInfinity 回 或 Single.NegativeInfinity 。
另請參閱
適用於
Round(Single)
- 來源:
- MathF.cs
- 來源:
- MathF.cs
- 來源:
- 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
要四捨五入的單精確度浮點數。
傳回
最接近 x
的整數。 如果 x
的小數部分正好為兩個整數的中間數 (一個為偶數,另一個為奇數),則會傳回偶數。 請注意,這個方法會傳回 Single,而不是整數類型。
備註
這個方法使用 的預設四捨五入慣例 MidpointRounding.ToEven 。
重要
將中間點值捨入時,捨入演算法會執行相等性測試。 因為二進位表示法與浮點數格式的精確度問題,方法可能傳回非預期的值。 如需詳細資訊,請參閱 四捨五入和有效位數。
如果引數的值 x
是 Single.NaN ,則方法會傳 Single.NaN 回 。 如果 為 x
Single.PositiveInfinity 或 Single.NegativeInfinity ,則方法會分別傳 Single.PositiveInfinity 回 或 Single.NegativeInfinity 。
給呼叫者的注意事項
由於遺失可能因為將十進位值表示為浮點數或對浮點數執行算數運算而造成的精確度遺失,在某些情況下, Round(Single) 方法可能不會將中間點值四捨五入到最接近的偶數整數。
另請參閱
適用於
Round(Single, Int32)
- 來源:
- MathF.cs
- 來源:
- MathF.cs
- 來源:
- 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
傳回值中小數點後數字的數目。
傳回
最接近 x
的數字,其中包含等於 digits
的小數位數。
例外狀況
digits
小於 0 或大於 6。
備註
引數的值 digits
可以介於 0 到 6 之間。 請注意,6 是類型所支援 Single 之整數和小數位數的最大數目。
這個方法使用 的預設四捨五入慣例 MidpointRounding.ToEven 。
重要
將中間點值捨入時,捨入演算法會執行相等性測試。 因為二進位表示法與浮點數格式的精確度問題,方法可能傳回非預期的值。 如需詳細資訊,請參閱 四捨五入和有效位數。
如果引數的值 x
是 Single.NaN ,則方法會傳 Single.NaN 回 。 如果 為 x
Single.PositiveInfinity 或 Single.NegativeInfinity ,則方法會分別傳 Single.PositiveInfinity 回 或 Single.NegativeInfinity 。
另請參閱
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應