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 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 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ 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 ⟨debian-l10n-german@lists.debian.org⟩.