Scroll to navigation

round(3) Library Functions Manual round(3)

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.

2. Mai 2024 Linux man-pages (unveröffentlicht)