Math.IEEERemainder(Double, Double) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает оставшуюся часть, полученную от деления указанного числа на другое указанное число.
public:
static double IEEERemainder(double x, double y);public static double IEEERemainder(double x, double y);static member IEEERemainder : double * double -> doublePublic Shared Function IEEERemainder (x As Double, y As Double) As DoubleПараметры
- x
- Double
Дивиденд.
- y
- Double
Делитель.
Возвращаемое значение
Число равно x - (yQ), где Q является кворентом округления до ближайшегоy / x целого числа (если x / y падает на полпути между двумя целыми числами, возвращается даже целое число).
If x - (y Q) равно нулю, значение +0 возвращается, если положительный или -0, если xx отрицательный.
Если y = 0, NaN возвращается.
Примеры
Следующий пример контрастирует оставшуюся часть, возвращаемую методом, с оставшимся, возвращаемым IEEERemainderоператором остальных элементов.
using System;
public class Example
{
public static void Main()
{
Console.WriteLine($"{"IEEERemainder",35} {"Remainder operator",20}");
ShowRemainders(3, 2);
ShowRemainders(4, 2);
ShowRemainders(10, 3);
ShowRemainders(11, 3);
ShowRemainders(27, 4);
ShowRemainders(28, 5);
ShowRemainders(17.8, 4);
ShowRemainders(17.8, 4.1);
ShowRemainders(-16.3, 4.1);
ShowRemainders(17.8, -4.1);
ShowRemainders(-17.8, -4.1);
}
private static void ShowRemainders(double number1, double number2)
{
var formula = $"{number1} / {number2} = ";
var ieeeRemainder = Math.IEEERemainder(number1, number2);
var remainder = number1 % number2;
Console.WriteLine($"{formula,-16} {ieeeRemainder,18} {remainder,20}");
}
}
// The example displays the following output:
//
//
// IEEERemainder Remainder operator
// 3 / 2 = -1 1
// 4 / 2 = 0 0
// 10 / 3 = 1 1
// 11 / 3 = -1 2
// 27 / 4 = -1 3
// 28 / 5 = -2 3
// 17.8 / 4 = 1.8 1.8
// 17.8 / 4.1 = 1.4 1.4
// -16.3 / 4.1 = 0.0999999999999979 -4
// 17.8 / -4.1 = 1.4 1.4
// -17.8 / -4.1 = -1.4 -1.4
open System
let showRemainders number1 number2 =
let formula = $"{number1} / {number2} = "
let ieeeRemainder = Math.IEEERemainder(number1, number2)
let remainder = number1 % number2
printfn $"{formula,-16} {ieeeRemainder,18} {remainder,20}"
printfn " IEEERemainder Remainder operator"
showRemainders 3 2
showRemainders 4 2
showRemainders 10 3
showRemainders 11 3
showRemainders 27 4
showRemainders 28 5
showRemainders 17.8 4
showRemainders 17.8 4.1
showRemainders -16.3 4.1
showRemainders 17.8 -4.1
showRemainders -17.8 -4.1
// The example displays the following output:
//
//
// IEEERemainder Remainder operator
// 3 / 2 = -1 1
// 4 / 2 = 0 0
// 10 / 3 = 1 1
// 11 / 3 = -1 2
// 27 / 4 = -1 3
// 28 / 5 = -2 3
// 17.8 / 4 = 1.8 1.8
// 17.8 / 4.1 = 1.4 1.4
// -16.3 / 4.1 = 0.0999999999999979 -4
// 17.8 / -4.1 = 1.4 1.4
// -17.8 / -4.1 = -1.4 -1.4
Module Example
Public Sub Main()
Console.WriteLine($"{"IEEERemainder",35} {"Remainder operator",20}")
ShowRemainders(3, 2)
ShowRemainders(4, 2)
ShowRemainders(10, 3)
ShowRemainders(11, 3)
ShowRemainders(27, 4)
ShowRemainders(28, 5)
ShowRemainders(17.8, 4)
ShowRemainders(17.8, 4.1)
ShowRemainders(-16.3, 4.1)
ShowRemainders(17.8, -4.1)
ShowRemainders(-17.8, -4.1)
End Sub
Private Sub ShowRemainders(number1 As Double, number2 As Double)
Dim formula As String = $"{number1} / {number2} = "
Dim ieeeRemainder As Double = Math.IEEERemainder(number1, number2)
Dim remainder As Double = number1 Mod number2
Console.WriteLine($"{formula,-16} {ieeeRemainder,18} {remainder,20}")
End Sub
End Module
' The example displays the following output:
'
' IEEERemainder Remainder operator
' 3 / 2 = -1 1
' 4 / 2 = 0 0
' 10 / 3 = 1 1
' 11 / 3 = -1 2
' 27 / 4 = -1 3
' 28 / 5 = -2 3
' 17.8 / 4 = 1.8 1.8
' 17.8 / 4.1 = 1.4 1.4
' -16.3 / 4.1 = 0.0999999999999979 -4
' 17.8 / -4.1 = 1.4 1.4
' -17.8 / -4.1 = -1.4 -1.4
Комментарии
Эта операция соответствует остальной операции, определенной в разделе 5.1 ANSI/IEEE Std 754-1985; IEEE Standard for Binary Floating-Point Arithmetic; Институт инженеров электротехники и электроники, Inc; 1985.
Метод IEEERemainder не совпадает с остальным оператором. Хотя оба возвращают оставшуюся часть после деления, используемые формулы отличаются. Формула метода IEEERemainder :
IEEERemainder = dividend - (divisor * Math.Round(dividend / divisor))
В отличие от этого, формула для остальных операторов:
Remainder = (Math.Abs(dividend) - (Math.Abs(divisor) *
(Math.Floor(Math.Abs(dividend) / Math.Abs(divisor))))) *
Math.Sign(dividend)
