BEZEICHNUNG

       nearbyint, nearbyintf, nearbyintl, rint, rintf, rintl - auf die nächste Ganzzahl runden

BIBLIOTHEK

       Mathematik-Bibliothek (libm, -lm)

ÜBERSICHT

       #include <math.h>

       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 Fließkommaformat. Dazu benutzen sie die aktuelle Rundungsrichtung (siehe fesetround(3)) und lösen
       keine inexact-Ausnahme aus. Falls die aktuelle Rundungsrichtung auf das  Nächste  abzielt,  runden  diese
       Funktionen, wenn der Wert in der Mitte liegt, gemäß IEEE-754 auf eine gerade Ganzzahl.

       Die  Funktionen  rint(),  rintf()  und  rintl()  tun  das  gleiche,  lösen aber eine inexact-Ausnahme aus
       (FE_INEXACT, mittels fetestexcept(3) prüfbar), wenn sich das Ergebnis im Wert vom Argument unterscheidet.

RÜCKGABEWERT

       Diese Funktionen liefern den gerundeten Ganzzahlwert zurück.

       Falls x ganzzahlig, +0, -0, NaN (keine Zahl) oder unendlich ist, wird x selbst zurückgegeben.

FEHLER

       Es treten keine Fehler auf. POSIX.1-2001 dokumentiert für Überläufe einen Bereichsfehler, aber lesen  Sie
       dazu die ANMERKUNGEN.

ATTRIBUTE

       Siehe attributes(7) für eine Erläuterung der in diesem Abschnitt verwandten Ausdrücke.
       ┌─────────────────────────────────────────────────────────────────────┬───────────────────────┬─────────┐
       │ Schnittstelle                                                       │ Attribut              │ Wert    │
       ├─────────────────────────────────────────────────────────────────────┼───────────────────────┼─────────┤
       │ nearbyint(), nearbyintf(), nearbyintl(), rint(), rintf(), rintl()   │ Multithread-Fähigkeit │ MT-Safe │
       └─────────────────────────────────────────────────────────────────────┴───────────────────────┴─────────┘

STANDARDS

       C99, POSIX.1-2001, POSIX.1-2008.

ANMERKUNGEN

       SUSv2  und  POSIX.1-2001  enthalten  Text  über Überläufe (die errno auf ERANGE setzen oder eine FE_OVER‐
       FLOW-Ausnahme auslösen können). In der Praxis kann das Ergebnis auf einem aktuellen Rechner  nicht  über‐
       laufen,  so  dass  diese Überlegungen zur Fehlerbehandlung einfach Unsinn sind. (Genauer gesagt, kann ein
       Überlauf nur eintreten, wenn der maximale Wert des Exponenten kleiner als die Anzahl  der  Mantissen-Bits
       ist. Für die IEEE-754-Standard-32- und 64-Bit-Fließkommazahlen ist der Maximalwert für den Exponenten 127
       (beziehungsweise  1023) und die Anzahl der Mantissen-Bits einschließliche des impliziten Bits ist 24 (be‐
       ziehungsweise 53).)

       Wenn Sie den gerundeten Wert in einem ganzzahligen Typ speichern möchten, wollen  Sie  stattdessen  wahr‐
       scheinlich eine der in lrint(3) beschriebenen Funktionen benutzen.

SIEHE AUCH

       ceil(3), floor(3), lrint(3), round(3), trunc(3)

ÜBERSETZUNG

       Die  deutsche  Übersetzung  dieser  Handbuchseite  wurde von Markus Schmitt <fw@math.uni-sb.de> und Chris
       Leick <c.leick@vollbio.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.

Linux man-pages 6.03                             5. Februar 2023                                         rint(3)