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.

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).