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.

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-Sicher │
       └───────────────────────────────────────────────────────────────────┴───────────────────────┴───────────┘

STANDARDS

       C11, POSIX.1-2008.

GESCHICHTE

       Glibc 2.1. C99, POSIX.1-2001.

ANMERKUNGEN

       POSIX.1-2001 enthält Text über Überläufe (die errno auf  ERANGE  setzen  oder  eine  FE_OVERFLOW-Ausnahme
       auslösen  können).  In der Praxis kann das Ergebnis auf einem aktuellen Rechner nicht überlaufen, 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ß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.8                                2. Mai 2024                                          round(3)