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

使用する丸め方法を指定する列挙値の 1 つ。

戻り値

Single

小数部の x 数字を持つ digits に丸められた数値。 x の小数部の桁数が digits よりも少ない場合、x がそのまま返されます。

例外

ArgumentOutOfRangeException

digits が 0 より小さいか、6 を超えています。

ArgumentException

mode が MidpointRounding の正しい値ではありません。

注釈

引数の値の digits 範囲は 0 から 6 です。 型でサポートされる整数と小数部の Single 最大桁数は 6 です。

重要

中間値を丸める際は、丸め処理アルゴリズムによって等値テストが実行されます。 浮動小数点形式での精度およびバイナリ表現における問題により、メソッドによって返される値が予測不可能な場合があります。 詳細については、「 丸めと精度」を参照してください。

引数の値が の x 場合、メソッドは Single.NaNを返します Single.NaN。 が または の場合x、メソッドはそれぞれ または Single.NegativeInfinityを返しますSingle.PositiveInfinity。Single.NegativeInfinitySingle.PositiveInfinity

こちらもご覧ください

• 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

使用する丸め方法を指定する列挙値の 1 つ。

戻り値

Single

丸め規則を x 使用して mode に丸められた整数。 このメソッドは、整数型ではなく を Single 返します。

例外

ArgumentException

mode が MidpointRounding の正しい値ではありません。

注釈

重要

中間値を丸める際は、丸め処理アルゴリズムによって等値テストが実行されます。 浮動小数点形式での精度およびバイナリ表現における問題により、メソッドによって返される値が予測不可能な場合があります。 詳細については、「 丸めと精度」を参照してください。

引数の値が の x 場合、メソッドは Single.NaNを返します Single.NaN。 が または の場合x、メソッドはそれぞれ または Single.NegativeInfinityを返しますSingle.PositiveInfinity。Single.NegativeInfinitySingle.PositiveInfinity

こちらもご覧ください

• 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 の小数部が 2 つの整数 (一方が偶数で、もう一方が奇数) の中間にある場合は、偶数が返されます。 このメソッドは、整数型ではなく Single を返します。

注釈

このメソッドでは、 の既定の丸め規則 MidpointRounding.ToEvenが使用されます。

重要

中間値を丸める際は、丸め処理アルゴリズムによって等値テストが実行されます。 浮動小数点形式での精度およびバイナリ表現における問題により、メソッドによって返される値が予測不可能な場合があります。 詳細については、「 丸めと精度」を参照してください。

引数の値が の x 場合、メソッドは Single.NaNを返します Single.NaN。 が または の場合x、メソッドはそれぞれ または Single.NegativeInfinityを返しますSingle.PositiveInfinity。Single.NegativeInfinitySingle.PositiveInfinity

注意 (呼び出し元)

小数点の値を浮動小数点数として表したり、浮動小数点値に対して算術演算を実行したりすると、精度が低下するため、メソッド 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。 が または の場合x、メソッドはそれぞれ または Single.NegativeInfinityを返しますSingle.PositiveInfinity。Single.NegativeInfinitySingle.PositiveInfinity

こちらもご覧ください

• Ceiling(Single)
• Floor(Single)