WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

remainder — Gleitkomma-Rest

remainder berechnet einen Rest anhand des nächstgelegenen ganzzahligen Quotienten; bei genau halbem Abstand wird die gerade Zahl gewählt.

Version: C23; repository compiler flag, production runtime not attested

Syntax

#include <math.h>
double remainder(double x, double y);

remainder aus <math.h> nimmt double-Werte entgegen und gibt einen double zurück. Für endliche Argumente mit y != 0 berechnet die Funktion x - n*y: n ist die ganze Zahl, die dem exakten Quotienten x / y am nächsten liegt. Bei genau gleichem Abstand wird unabhängig vom Rundungsmodus die gerade Zahl gewählt.

Anders als bei fmod kann das Ergebnis ein anderes Vorzeichen als x haben. Ein Ergebnis von null behält das Vorzeichen von x. Der Operator % setzt ganzzahlige Operanden voraus.

Für y == 0 kann nach der Basisspezifikation von C ein Definitionsbereichsfehler auftreten. Tritt kein solcher Fehler auf, garantiert die Spezifikation nicht, dass null zurückgegeben wird. Gemäß Anhang F ergibt ein Divisor von null oder ein unendliches x NaN und löst den Invalid-Ausnahmezustand aus, sofern keines der Argumente NaN ist.

Beispiele

#include <math.h>
#include <stdio.h>

int main(void)
{
    printf("%.0f\n", remainder(7.0, 2.0));
    printf("%.0f\n", remainder(5.0, 2.0));
    return 0;
}

Ergebnis

-1
1

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen