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

Одно из значений перечисления, указывающее, какую стратегию округления следует использовать.

Возвращаемое значение

Single

Число, x округленное до , имеет digits дробные цифры. Если x имеет меньшее количество цифр дробной части, чем digits, то x возвращается без изменений.

Исключения

ArgumentOutOfRangeException

Параметр digits имеет значение меньше 0 или больше 6.

ArgumentException

mode не является допустимым значением MidpointRounding.

Комментарии

Значение аргумента digits может варьироваться от 0 до 6. Максимальное число целых и дробных цифр, поддерживаемых типом Single , равно 6.

Важно!

При округлении средних значений алгоритм округления выполняет проверку равенства. Из-за проблем с двоичным представлением и точностью формата с плавающей запятой значение, возвращаемое этим методом, может быть непредвиденным. Дополнительные сведения см. в разделе Округление и точность.

Если аргумент имеет Single.NaNзначение x , метод возвращает 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

Целое число, округляемое x до с помощью соглашения об mode округлении. Этот метод возвращает Single вместо целочисленного типа.

Исключения

ArgumentException

mode не является допустимым значением MidpointRounding.

Комментарии

Важно!

При округлении средних значений алгоритм округления выполняет проверку равенства. Из-за проблем с двоичным представлением и точностью формата с плавающей запятой значение, возвращаемое этим методом, может быть непредвиденным. Дополнительные сведения см. в разделе Округление и точность.

Если аргумент имеет Single.NaNзначение x , метод возвращает 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. Если дробная часть x находится на равном расстоянии от двух целых чисел (четного и нечетного), возвращается четное число. Обратите внимание, что данный метод возвращает не целочисленное значение, а значение типа Single.

Комментарии

Этот метод использует соглашение округления по умолчанию для MidpointRounding.ToEven.

Важно!

При округлении средних значений алгоритм округления выполняет проверку равенства. Из-за проблем с двоичным представлением и точностью формата с плавающей запятой значение, возвращаемое этим методом, может быть непредвиденным. Дополнительные сведения см. в разделе Округление и точность.

Если аргумент имеет Single.NaNзначение x , метод возвращает 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

Число, ближайшее к параметру x, содержащем количество дробных разрядов, которое равно digits.

Исключения

ArgumentOutOfRangeException

Параметр digits имеет значение меньше 0 или больше 6.

Комментарии

Значение аргумента digits может варьироваться от 0 до 6. Обратите внимание, что 6 — это максимальное число целых и дробных цифр, поддерживаемых типом Single .

Этот метод использует соглашение округления по умолчанию для MidpointRounding.ToEven.

Важно!

При округлении средних значений алгоритм округления выполняет проверку равенства. Из-за проблем с двоичным представлением и точностью формата с плавающей запятой значение, возвращаемое этим методом, может быть непредвиденным. Дополнительные сведения см. в разделе Округление и точность.

Если аргумент имеет Single.NaNзначение x , метод возвращает Single.NaN. Если x имеет значение Single.PositiveInfinity или Single.NegativeInfinity, метод возвращает Single.PositiveInfinity или Single.NegativeInfinityсоответственно.

См. также раздел

• Ceiling(Single)
• Floor(Single)