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 IEEERemainder -Methode zurückgegeben wird, mit dem Rest, der vom rest-Operator zurückgegeben wird, kontrastiert.
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
Hinweise
Dieser Vorgang entspricht dem in Abschnitt 5.1 der ANSI/IEEE Std 754-1985 definierten Restvorgang; IEEE-Standard für Binäre Floating-Point Arithmetik; Institut für Elektro- und Elektronikingenieure, Inc; 1985.
Die IEEERemainder -Methode ist nicht identisch mit dem Restoperator. Obwohl beide den Rest nach der Division zurückgeben, sind die verwendeten Formeln unterschiedlich. Die Formel für die IEEERemainder -Methode lautet:
IEEERemainder = dividend - (divisor * Math.Round(dividend / divisor))
Im Gegensatz dazu lautet die Formel für den Restoperator:
Remainder = (Math.Abs(dividend) - (Math.Abs(divisor) *
(Math.Floor(Math.Abs(dividend) / Math.Abs(divisor))))) *
Math.Sign(dividend)
