MathF.Round Метод

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Перегрузки

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 с использованием соглашения об округлениях mode

Исключения

ArgumentOutOfRangeException

digits меньше 0 или больше 6.

ArgumentException

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

Комментарии

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

Важный

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

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

Исключения

ArgumentException

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

Комментарии

Важный

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

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

Комментарии

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

Важный

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

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

Важный

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

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

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

• Ceiling(Single)
• Floor(Single)