Math.IEEERemainder(Double, Double) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt den Rest der Division zweier angegebener Zahlen zurück.
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 DoubleParameter
- x
- Double
Ein Dividend.
- y
- Double
Ein Divisor.
Gibt zurück
Eine Zahl gleich x – (y Q), wobei Q der auf die nächste ganze Zahl gerundete Quotient von x / y ist (wenn x / y genau in der Mitte zwischen zwei ganzen Zahlen liegt, wird die gerade ganze Zahl zurückgegeben).
Wenn x - (yQ) gleich 0 ist, wird bei positivem x +0 und bei negativem x -0 zurückgegeben.
Wenn y = 0 ist, wird NaN zurückgegeben.
Beispiele
Im folgenden Beispiel wird der Rest, der von der -Methode zurückgegeben wird, mit dem Rest vom IEEERemainder Restoperator gegenüberkontrahiert.
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
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
Hinweise
Dieser Vorgang entspricht dem Restvorgang, der in Abschnitt 5.1 von ANSI/IEEE Std 754-1985 definiert ist. IEEE Standard for Binary Floating-Point Arithmetik; Institute of Electrical and Electronics Engineers, Inc; 1985.
Die IEEERemainder -Methode ist nicht mit dem Restoperator identisch. Obwohl beide den Rest nach der Division zurückgeben, unterscheiden sich die von ihnen verwendeten Formeln. Die Formel für die IEEERemainder Methode ist:
IEEERemainder = dividend - (divisor * Math.Round(dividend / divisor))
Im Gegensatz dazu ist die Formel für den Restoperator:
Remainder = (Math.Abs(dividend) - (Math.Abs(divisor) *
(Math.Floor(Math.Abs(dividend) / Math.Abs(divisor))))) *
Math.Sign(dividend)