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. Если x параметр Single.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. Если x параметр Single.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. Если x параметр Single.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. Если x параметр Single.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.

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

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