BEZEICHNUNG

       round, roundf, roundl - zur nächsten Ganzzahl, weg von Null, runden

BIBLIOTHEK

       Mathematik-Bibliothek (libm, -lm)

ÜBERSICHT

       #include <math.h>

       double round(double x);
       float roundf(float x);
       long double roundl(long double x);

   Mit Glibc erforderliche Feature-Test-Makros (siehe feature_test_macros(7)):

       round(), roundf(), roundl():
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L

BESCHREIBUNG

       Diese  Funktionen  runden  x zur nächsten Ganzzahl. Sie runden allerdings Fälle in der Mitte weg von Null
       (unabhängig von der aktuellen Rundungsrichtung, siehe fenv(3)), statt zu der  nächsten  geraden  Ganzzahl
       wie rint(3).

       Beispielsweise ist round(0.5) 1.0 und round(-0.5) ist -1.0.

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.

VERSIONEN

       Diese Funktionen wurden in Glibc 2.1 hinzugefügt.

ATTRIBUTE

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

STANDARDS

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

ANMERKUNGEN

       POSIX.1-2001 enthält Text über Überläufe (die errno auf ERANGE setzen oder eine FE_OVERFLOW-Ausnahme aus‐
       lösen können). In der Praxis kann das Ergebnis auf einem aktuellen Rechner nicht überlaufen, so dass die‐
       se Überlegungen zur Fehlerbehandlung einfach Unsinn sind. (Genauer gesagt, kann ein Überlauf nur  eintre‐
       ten,  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 (beziehungs‐
       weise 1023) und die Anzahl der Mantissen-Bits einschließlich  des  impliziten  Bits  24  (beziehungsweise
       53).)

       Falls  Sie  den gerundeten Wert im Typ »integer« speichern möchten, wollen Sie wahrscheinlich stattdessen
       eine der in lround(3) beschriebenen Funktionen verwenden.

SIEHE AUCH

       ceil(3), floor(3), lround(3), nearbyint(3), rint(3), trunc(3)

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von 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.

Linux man-pages 6.03                            15. Dezember 2022                                       round(3)