Provided by: manpages-de-dev_4.27.0-1_all 
BEZEICHNUNG
fmod, fmodf, fmodl - Funktionen berechnen Divisionsrest als Fließkommazahl
BIBLIOTHEK
Mathematik-Bibliothek (libm, -lm)
ÜBERSICHT
#include <math.h>
double fmod(double x, double y);
float fmodf(float x, float y);
long double fmodl(long double x, long double y);
Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)):
fmodf(), fmodl():
_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
|| /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
|| /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
BESCHREIBUNG
Diese Funktionen berechnen den Rest der Division von x durch y als Fließkommazahl. Der Rückgabewert ist x
- n * y, wobei n der zur Ganzzahl abgerundete Quotient von x / y ist.
Um den Modulus zu erhalten, genauer das kleinste positive Residuum, müssen Sie die Ausgabe von fmod wie
folgt anpassen:
z = fmod(x, y);
if (z < 0)
z += y;
Alternativ können Sie das als fmod(fmod(x, y) + y, y) formulieren, aber das zweite fmod kostet deutlich
mehr als eine Verzweigung.
RÜCKGABEWERT
Bei Erfolg geben diese Funktionen den Wert x - n*y für diejenige Ganzzahl n zurück, so dass der
zurückgegebene Wert das gleiche Vorzeichen wie x hat und einen Betrag, der kleiner ist als der Betrag von
y.
Falls x oder y keine Zahlen (»NaN«) sind, wird »NaN« zurückgegeben.
Falls x unendlich ist, tritt ein Wertebereichsfehler auf und es wird »NaN« zurückgegeben.
Falls y Null ist, tritt ein Wertebereichsfehler auf und es wird »NaN« zurückgegeben.
Falls x +0 (-0) und y nicht Null ist, wird +0 (-0) zurückgegeben.
FEHLER
In math_error(7) erfahren Sie, wie Sie Fehler bei der Ausführung dieser Funktionen erkennen.
Die folgenden Fehler können auftreten:
Wertebereichsfehler: x ist unendlich
errno wird auf EDOM gesetzt (siehe aber FEHLER). Es wird der Fließkomma-Ausnahmefehler
»unzulässige Fließkommazahl« (FE_INVALID) ausgelöst.
Wertebereichsfehler: y ist Null
errno wird auf EDOM gesetzt. Es wird der Fließkomma-Ausnahmefehler »unzulässige Fließkommazahl«
(FE_INVALID) ausgelöst.
ATTRIBUTE
Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
┌───────────────────────────────────────────────────────────────────┬───────────────────────┬───────────┐
│ Schnittstelle │ Attribut │ Wert │
├───────────────────────────────────────────────────────────────────┼───────────────────────┼───────────┤
│ fmod(), fmodf(), fmodl() │ Multithread-Fähigkeit │ MT-Sicher │
└───────────────────────────────────────────────────────────────────┴───────────────────────┴───────────┘
STANDARDS
C11, POSIX.1-2008.
GESCHICHTE
C99, POSIX.1-2001.
Die Variante, die double zurückgibt, ist außerdem konform zu SVr4, 4.3BSD, C89.
FEHLER
Vor Glibc 2.10 setzte die Glibc-Implementierung errno nicht auf EDOM, wenn ein Wertebereichsfehler für
ein unendliches x auftrat.
BEISPIELE
Der Aufruf fmod(372, 360) liefert 348 zurück.
Der Aufruf fmod(-372, 360) liefert -12 zurück.
Der Aufruf fmod(-372, -360) liefert auch -12 zurück.
SIEHE AUCH
remainder(3)
ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von Markus Schmitt <fw@math.uni-sb.de>, Chris Leick
<c.leick@vollbio.de> und Helge Kreutzmann <debian@helgefjell.de> erstellt.
Diese Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer
bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die
Mailingliste der Übersetzer: debian-l10n-german@lists.debian.org.
Linux man-pages 6.9.1 2. Mai 2024 fmod(3)