.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH fmod 3 "17. Mai 2025" "Linux man\-pages 6.15" 
.SH BEZEICHNUNG
fmod, fmodf, fmodl \- Funktionen berechnen Divisionsrest als Fließkommazahl
.SH BIBLIOTHEK
Mathematik\-Bibliothek (\fIlibm\fP,\ \fI\-lm\fP)
.SH ÜBERSICHT
.nf
\fB#include <math.h>\fP
.P
\fBdouble fmod(double \fP\fIx\fP\fB, double \fP\fIy\fP\fB);\fP
\fBfloat fmodf(float \fP\fIx\fP\fB, float \fP\fIy\fP\fB);\fP
\fBlong double fmodl(long double \fP\fIx\fP\fB, long double \fP\fIy\fP\fB);\fP
.fi
.P
.RS -4
Mit Glibc erforderliche Feature\-Test\-Makros (siehe
\fBfeature_test_macros\fP(7)):
.RE
.P
\fBfmodf\fP(), \fBfmodl\fP():
.nf
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE
        || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.SH BESCHREIBUNG
Diese Funktionen berechnen den Rest der Division von \fIx\fP durch \fIy\fP als
Fließkommazahl. Der Rückgabewert ist \fIx\fP \- \fIn\fP * \fIy\fP, wobei \fIn\fP der zur
Ganzzahl abgerundete Quotient von \fIx\fP / \fIy\fP ist.
.P
Um den Modulus zu erhalten, genauer das kleinste positive Residuum, müssen
Sie die Ausgabe von \fBfmod\fP wie folgt anpassen:
.P
.in +4n
.nf
z = fmod(x, y);
if (z < 0)
	z += fabs(y);
.fi
.in
.P
Alternativ können Sie das als \fIfmod(fmod(x, y) + y, y)\fP formulieren, aber
das zweite \fBfmod\fP() kostet deutlich mehr als eine Ausführungs\-Verzweigung.
.SH RÜCKGABEWERT
Bei Erfolg geben diese Funktionen den Wert \fIx\fP\ \-\ \fIn\fP*\fIy\fP für diejenige
Ganzzahl \fIn\fP zurück, so dass der zurückgegebene Wert das gleiche Vorzeichen
wie \fIx\fP hat und einen Betrag, der kleiner ist als der Betrag von \fIy\fP.
.P
Falls \fIx\fP oder \fIy\fP keine Zahlen (»NaN«) sind, wird »NaN« zurückgegeben.
.P
Falls \fIx\fP unendlich ist, tritt ein Wertebereichsfehler auf und es wird
»NaN« zurückgegeben.
.P
Falls \fIy\fP Null ist, tritt ein Wertebereichsfehler auf und es wird »NaN«
zurückgegeben.
.P
Falls \fIx\fP +0 (\-0) und \fIy\fP nicht Null ist, wird +0 (\-0) zurückgegeben.
.SH FEHLER
In \fBmath_error\fP(7) erfahren Sie, wie Sie Fehler bei der Ausführung dieser
Funktionen erkennen.
.P
Die folgenden Fehler können auftreten:
.TP 
Wertebereichsfehler: \f[I]x\fR ist unendlich
\fIerrno\fP wird auf \fBEDOM\fP gesetzt (siehe aber FEHLER). Es wird der
Fließkomma\-Ausnahmefehler »unzulässige Fließkommazahl« (\fBFE_INVALID\fP)
ausgelöst.
.TP 
Wertebereichsfehler: \f[I]y\fR ist Null
.\" POSIX.1 documents an optional underflow error, but AFAICT it doesn't
.\" (can't?) occur -- mtk, Jul 2008
\fIerrno\fP wird auf \fBEDOM\fP gesetzt. Es wird der Fließkomma\-Ausnahmefehler
»unzulässige Fließkommazahl« (\fBFE_INVALID\fP) ausgelöst.
.SH ATTRIBUTE
Siehe \fBattributes\fP(7) für eine Erläuterung der in diesem Abschnitt
verwandten Ausdrücke.
.TS
allbox;
lbx lb lb
l l l.
Schnittstelle	Attribut	Wert
T{
.na
.nh
\fBfmod\fP(),
\fBfmodf\fP(),
\fBfmodl\fP()
T}	Multithread\-Fähigkeit	MT\-Sicher
.TE
.SH STANDARDS
C11, POSIX.1\-2008.
.SH GESCHICHTE
C99, POSIX.1\-2001.
.P
Die Variante, die \fIdouble\fP zurückgibt, ist außerdem konform zu SVr4,
4.3BSD, C89.
.SH FEHLER
.\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6784
Vor Glibc 2.10 setzte die Glibc\-Implementierung \fIerrno\fP nicht auf \fBEDOM\fP,
wenn ein Wertebereichsfehler für ein unendliches \fIx\fP auftrat.
.SH BEISPIELE
Der Aufruf \fIfmod(372, 360)\fP liefert 12 zurück.
.P
Der Aufruf \fIfmod(\-372, 360)\fP liefert \-12 zurück.
.P
Der Aufruf \fIfmod(\-372, \-360)\fP liefert auch \-12 zurück.
.SH "SIEHE AUCH"
\fBremainder\fP(3)
.PP
.SH Ü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.
.PP
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
.PP
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an die Mailingliste der Übersetzer:
.MT debian-l10n-german@lists.debian.org
.ME .