round(3) Library Functions Manual round(3)

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

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

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.

Diese Funktionen liefern den gerundeten Ganzzahlwert zurück.

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

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

Diese Funktionen wurden in Glibc 2.1 hinzugefügt.

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

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

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.

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.

15. Dezember 2022 Linux-Handbuchseiten 6.02