MathF.Round MathF.Round MathF.Round MathF.Round Method

Определение

Перегрузки

Round(Single, Int32, MidpointRounding) Round(Single, Int32, MidpointRounding) Round(Single, Int32, MidpointRounding) Round(Single, Int32, MidpointRounding)

Округляет значение с плавающей запятой одиночной точности до указанного числа знаков после запятой; использует указанное соглашение для округления значений посередине.Rounds a single-precision floating-point value to a specified number of fractional digits, and uses the specified rounding convention for midpoint values.

Round(Single, MidpointRounding) Round(Single, MidpointRounding) Round(Single, MidpointRounding) Round(Single, MidpointRounding)

Округляет значение с плавающей запятой одиночной точности до ближайшего целого числа; использует указанное соглашение для округления значений посередине.Rounds a single-precision floating-point value to the nearest integer, and uses the specified rounding convention for midpoint values.

Round(Single, Int32) Round(Single, Int32) Round(Single, Int32) Round(Single, Int32)

Округляет значение с плавающей запятой одиночной точности до указанного числа знаков после запятой; значения посередине округляются до ближайшего четного числа.Rounds a single-precision floating-point value to a specified number of fractional digits, and rounds midpoint values to the nearest even number.

Round(Single) Round(Single) Round(Single) Round(Single)

Округляет значение с плавающей запятой одиночной точности до ближайшего целого значения; значения посередине округляются до ближайшего четного числа.Rounds a single-precision floating-point value to the nearest integral value, and rounds midpoint values to the nearest even number.

Round(Single, Int32, MidpointRounding) Round(Single, Int32, MidpointRounding) Round(Single, Int32, MidpointRounding) Round(Single, Int32, MidpointRounding)

Округляет значение с плавающей запятой одиночной точности до указанного числа знаков после запятой; использует указанное соглашение для округления значений посередине.Rounds a single-precision floating-point value to a specified number of fractional digits, and uses the specified rounding convention for midpoint values.

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 Single Single Single

Округляемое число одиночной точности с плавающей запятой.A single-precision floating-point number to be rounded.

digits
Int32 Int32 Int32 Int32

Количество цифр дробной части в возвращаемом значении.The number of fractional digits in the return value.

mode
MidpointRounding MidpointRounding MidpointRounding MidpointRounding

Значение, задающее правило округления параметра x, если его значение находится ровно посредине между двумя другими числами.Specification for how to round x if it is midway between two other numbers.

Возвраты

Число, ближайшее к параметру x, количество цифр дробной части которого равно digits.The number nearest to x that has a number of fractional digits equal to digits. Если x имеет меньшее количество цифр дробной части, чем digits, то x возвращается без изменений.If x has fewer fractional digits than digits, x is returned unchanged.

Исключения

Параметр digits имеет значение меньше 0 или больше 6.digits is less than 0 or greater than 6.

mode не является допустимым значением MidpointRounding.mode is not a valid value of MidpointRounding.

Комментарии

Значение digits аргумента может изменяться от 0 до 6.The value of the digits argument can range from 0 to 6. Обратите внимание, что 6 максимальное число целой и дробной части, поддерживаемых Single типа.Note that 6 is the maximum number of integral and fractional digits supported by the Single type.

Важно!

При округлении средних значений алгоритм округления выполняет проверку равенства.When rounding midpoint values, the rounding algorithm performs an equality test. Из-за проблем с двоичным представлением и точностью формата с плавающей запятой значение, возвращаемое этим методом, может быть непредвиденным.Because of problems of binary representation and precision in the floating-point format, the value returned by the method can be unexpected. См. дополнительные сведения об округлении и точности.For more information, see "Rounding and precision".

Если значение x аргумент Single.NaN, метод возвращает Single.NaN.If the value of the x argument is Single.NaN, the method returns Single.NaN. Если xSingle.PositiveInfinity или Single.NegativeInfinity, метод возвращает Single.PositiveInfinity или Single.NegativeInfinity, соответственно.If x is Single.PositiveInfinity or Single.NegativeInfinity, the method returns Single.PositiveInfinity or Single.NegativeInfinity, respectively.

Дополнительно

Round(Single, MidpointRounding) Round(Single, MidpointRounding) Round(Single, MidpointRounding) Round(Single, MidpointRounding)

Округляет значение с плавающей запятой одиночной точности до ближайшего целого числа; использует указанное соглашение для округления значений посередине.Rounds a single-precision floating-point value to the nearest integer, and uses the specified rounding convention for midpoint values.

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 Single Single Single

Округляемое число одиночной точности с плавающей запятой.A single-precision floating-point number to be rounded.

mode
MidpointRounding MidpointRounding MidpointRounding MidpointRounding

Значение, задающее правило округления параметра x, если его значение находится ровно посредине между двумя другими числами.Specification for how to round x if it is midway between two other numbers.

Возвраты

Целое число, ближайшее к значению параметра x.The integer nearest x. Если x находится на равном расстоянии от двух целых чисел, четного и нечетного, то возвращаемое число определяется по значению параметра mode.If x is halfway between two integers, one of which is even and the other odd, then mode determines which of the two is returned. Обратите внимание, что данный метод возвращает не целочисленное значение, а значение типа Single.Note that this method returns a Single instead of an integral type.

Исключения

mode не является допустимым значением MidpointRounding.mode is not a valid value of MidpointRounding.

Комментарии

Важно!

При округлении средних значений алгоритм округления выполняет проверку равенства.When rounding midpoint values, the rounding algorithm performs an equality test. Из-за проблем с двоичным представлением и точностью формата с плавающей запятой значение, возвращаемое этим методом, может быть непредвиденным.Because of problems of binary representation and precision in the floating-point format, the value returned by the method can be unexpected. См. дополнительные сведения об округлении и точности.For more information, see "Rounding and precision".

Если значение x аргумент Single.NaN, метод возвращает Single.NaN.If the value of the x argument is Single.NaN, the method returns Single.NaN. Если xSingle.PositiveInfinity или Single.NegativeInfinity, метод возвращает Single.PositiveInfinity или Single.NegativeInfinity, соответственно.If x is Single.PositiveInfinity or Single.NegativeInfinity, the method returns Single.PositiveInfinity or Single.NegativeInfinity, respectively.

Дополнительно

Round(Single, Int32) Round(Single, Int32) Round(Single, Int32) Round(Single, Int32)

Округляет значение с плавающей запятой одиночной точности до указанного числа знаков после запятой; значения посередине округляются до ближайшего четного числа.Rounds a single-precision floating-point value to a specified number of fractional digits, and rounds midpoint values to the nearest even number.

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 Single Single Single

Округляемое число одиночной точности с плавающей запятой.A single-precision floating-point number to be rounded.

digits
Int32 Int32 Int32 Int32

Количество цифр дробной части в возвращаемом значении.The number of fractional digits in the return value.

Возвраты

Число, ближайшее к параметру x, количество цифр дробной части которого равно digits.The number nearest to x that contains a number of fractional digits equal to digits.

Исключения

Параметр digits имеет значение меньше 0 или больше 6.digits is less than 0 or greater than 6.

Комментарии

Значение digits аргумента может изменяться от 0 до 6.The value of the digits argument can range from 0 to 6. Обратите внимание, что 6 максимальное число целой и дробной части, поддерживаемых Single типа.Note that 6 is the maximum number of integral and fractional digits supported by the Single type.

Этот метод использует значение по умолчанию, округление соглашение о MidpointRounding.ToEven.This method uses the default rounding convention of MidpointRounding.ToEven.

Важно!

При округлении средних значений алгоритм округления выполняет проверку равенства.When rounding midpoint values, the rounding algorithm performs an equality test. Из-за проблем с двоичным представлением и точностью формата с плавающей запятой значение, возвращаемое этим методом, может быть непредвиденным.Because of problems of binary representation and precision in the floating-point format, the value returned by the method can be unexpected. См. дополнительные сведения об округлении и точности.For more information, see "Rounding and precision".

Если значение x аргумент Single.NaN, метод возвращает Single.NaN.If the value of the x argument is Single.NaN, the method returns Single.NaN. Если xSingle.PositiveInfinity или Single.NegativeInfinity, метод возвращает Single.PositiveInfinity или Single.NegativeInfinity, соответственно.If x is Single.PositiveInfinity or Single.NegativeInfinity, the method returns Single.PositiveInfinity or Single.NegativeInfinity, respectively.

Дополнительно

Round(Single) Round(Single) Round(Single) Round(Single)

Округляет значение с плавающей запятой одиночной точности до ближайшего целого значения; значения посередине округляются до ближайшего четного числа.Rounds a single-precision floating-point value to the nearest integral value, and rounds midpoint values to the nearest even number.

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 Single Single

Округляемое число одиночной точности с плавающей запятой.A single-precision floating-point number to be rounded.

Возвраты

Целое число, ближайшее к значению параметра x.The integer nearest x. Если дробная часть x находится на равном расстоянии от двух целых чисел (четного и нечетного), возвращается четное число.If the fractional component of x is halfway between two integers, one of which is even and the other odd, then the even number is returned. Обратите внимание, что данный метод возвращает не целочисленное значение, а значение типа Single.Note that this method returns a Single instead of an integral type.

Комментарии

Этот метод использует значение по умолчанию, округление соглашение о MidpointRounding.ToEven.This method uses the default rounding convention of MidpointRounding.ToEven.

Важно!

При округлении средних значений алгоритм округления выполняет проверку равенства.When rounding midpoint values, the rounding algorithm performs an equality test. Из-за проблем с двоичным представлением и точностью формата с плавающей запятой значение, возвращаемое этим методом, может быть непредвиденным.Because of problems of binary representation and precision in the floating-point format, the value returned by the method can be unexpected. См. дополнительные сведения об округлении и точности.For more information, see "Rounding and precision".

Если значение x аргумент Single.NaN, метод возвращает Single.NaN.If the value of the x argument is Single.NaN, the method returns Single.NaN. Если xSingle.PositiveInfinity или Single.NegativeInfinity, метод возвращает Single.PositiveInfinity или Single.NegativeInfinity, соответственно.If x is Single.PositiveInfinity or Single.NegativeInfinity, the method returns Single.PositiveInfinity or Single.NegativeInfinity, respectively.

Примечания для тех, кто вызывает этот метод

Из-за потери точности, которая может быть результатом представляющих десятичные значения как числа с плавающей запятой, или выполнение арифметических операций над значениями с плавающей запятой, в некоторых случаях Round(Single) метод могут отсутствовать для округления значения средней точки ближайшего четного целого.Because of the loss of precision that can result from representing decimal values as floating-point numbers or performing arithmetic operations on floating-point values, in some cases the Round(Single) method may not appear to round midpoint values to the nearest even integer.

Дополнительно

Применяется к