rint(3) Library Functions Manual rint(3) BEZEICHNUNG nearbyint, nearbyintf, nearbyintl, rint, rintf, rintl - auf die nachste Ganzzahl runden BIBLIOTHEK Mathematik-Bibliothek (libm, -lm) UBERSICHT #include double nearbyint(double x); float nearbyintf(float x); long double nearbyintl(long double x); double rint(double x); float rintf(float x); long double rintl(long double x); Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)): nearbyint(), nearbyintf(), nearbyintl(): _POSIX_C_SOURCE >= 200112L || _ISOC99_SOURCE rint(): _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE >= 500 || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE rintf(), rintl(): _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L || /* Seit Glibc 2.19: */ _DEFAULT_SOURCE || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE BESCHREIBUNG Die Funktionen nearbyint(), nearbyintf() und nearbyintl() runden ihre Argumente auf einen ganzzahligen Wert im Fliesskommaformat. Dazu benutzen sie die aktuelle Rundungsrichtung (siehe fesetround(3)) und losen keine inexact-Ausnahme aus. Falls die aktuelle Rundungsrichtung auf das Nachste abzielt, runden diese Funktionen, wenn der Wert in der Mitte liegt, gemass IEEE-754 auf eine gerade Ganzzahl. Die Funktionen rint(), rintf() und rintl() tun das gleiche, losen aber eine inexact-Ausnahme aus (FE_INEXACT, mittels fetestexcept(3) prufbar), wenn sich das Ergebnis im Wert vom Argument unterscheidet. RUCKGABEWERT Diese Funktionen liefern den gerundeten Ganzzahlwert zuruck. Falls x ganzzahlig, +0, -0, NaN (keine Zahl) oder unendlich ist, wird x selbst zuruckgegeben. FEHLER Es treten keine Fehler auf. POSIX.1-2001 dokumentiert fur Uberlaufe einen Bereichsfehler, aber lesen Sie dazu die ANMERKUNGEN. ATTRIBUTE Siehe attributes(7) fur eine Erlauterung der in diesem Abschnitt verwandten Ausdrucke. +--------------------------------+-------------------------+-----------+ |Schnittstelle | Attribut | Wert | +--------------------------------+-------------------------+-----------+ |nearbyint(), nearbyintf(), | Multithread-Fahigkeit | MT-Sicher | |nearbyintl(), rint(), rintf(), | | | |rintl() | | | +--------------------------------+-------------------------+-----------+ STANDARDS C11, POSIX.1-2008. GESCHICHTE C99, POSIX.1-2001. ANMERKUNGEN SUSv2 und POSIX.1-2001 enthalten Text uber Uberlaufe (die errno auf ERANGE setzen oder eine FE_OVERFLOW-Ausnahme auslosen konnen). In der Praxis kann das Ergebnis auf einem aktuellen Rechner nicht uberlaufen, so dass diese Uberlegungen zur Fehlerbehandlung einfach Unsinn sind. (Genauer gesagt, kann ein Uberlauf nur eintreten, wenn der maximale Wert des Exponenten kleiner als die Anzahl der Mantissen-Bits ist. Fur die IEEE-754-Standard-32- und 64-Bit-Fliesskommazahlen ist der Maximalwert fur den Exponenten 127 (beziehungsweise 1023) und die Anzahl der Mantissen-Bits einschliessliche des impliziten Bits ist 24 (beziehungsweise 53).) Wenn Sie den gerundeten Wert in einem ganzzahligen Typ speichern mochten, wollen Sie stattdessen wahrscheinlich eine der in lrint(3) beschriebenen Funktionen benutzen. SIEHE AUCH ceil(3), floor(3), lrint(3), round(3), trunc(3) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Markus Schmitt und Chris Leick erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . Linux man-pages 6.06 31. Oktober 2023 rint(3)