BEZEICHNUNG

       nearbyint, nearbyintf, nearbyintl, rint, rintf, rintl - auf die nächste Ganzzahl runden

ÜBERSICHT

       #include <math.h>

       double nearbyint(double x);
       float nearbyintf(float x);
       long double nearbyintl(long double x);

       double rint(double x);
       float rintf(float x);
       long double rintl(long double x);

       Linken Sie mit der Option -lm.

   Mit Glibc erforderliche Makros (siehe feature_test_macros(7)):

       nearbyint(), nearbyintf(), nearbyintl():
           _XOPEN_SOURCE >= 600 || _POSIX_C_SOURCE >= 200112L || _ISOC99_SOURCE;
           oder cc -std=c99
       rint():
           _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED ||
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L;
           oder cc -std=c99
       rintf(), rintl():
           _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L;
           oder cc -std=c99

BESCHREIBUNG

       Die  Funktionen  nearbyint(),  nearbyintf() und nearbyintl() runden ihre Argumente auf einen ganzzahligen
       Wert im Fließkommaformat. Dazu benutzen sie die aktuelle Rundungsrichtung (siehe fesetround(3)) und lösen
       keine inexact-Ausnahme aus. Falls die aktuelle Rundungsrichtung auf das  Nächste  abzielt,  runden  diese
       Funktionen, wenn der Wert in der Mitte liegt, gemäß IEEE-754 auf eine gerade Ganzzahl.

       Die  Funktionen  rint(),  rintf()  und  rintl()  tun  das  gleiche,  lösen aber eine inexact-Ausnahme aus
       (FE_INEXACT, mittels fetestexcept(3) prüfbar), wenn sich das Ergebnis im Wert vom Argument unterscheidet.

RÜCKGABEWERT

       Diese Funktionen liefern den gerundeten ganzzahligen Wert 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    │
       ├────────────────────────────┼───────────────────────┼─────────┤
       │ nearbyint(), nearbyintf(), │ Multithread-Fähigkeit │ MT-Safe │
       │ nearbyintl(), rint(),      │                       │         │
       │ rintf(), rintl()           │                       │         │
       └────────────────────────────┴───────────────────────┴─────────┘

KONFORM ZU

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

ANMERKUNGEN

       SUSv2   und  POSIX.1-2001  enthalten  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 einer  tatsächlichen  Maschine
       nicht  überlaufen, da dieses Fehlerbehandlungszeug purer Unsinn ist. (Genaugenommen kann ein Überlauf nur
       auftreten, wenn der maximale Wert der  Exponenten  kleiner  ist  als  die  der  Mantissen-Bits.  Für  die
       IEEE-754-Standard-32-   und   64-Bit-Fließkommazahlen   ist   der  Maximalwert  für  den  Exponenten  128
       (beziehungsweise 1024) und die Anzahl der Mantissen-Bits 24 (beziehungsweise 53).)

       Wenn Sie den gerundeten Wert  in  einem  ganzzahligen  Typ  speichern  möchten,  wollen  Sie  stattdessen
       wahrscheinlich eine der in lrint(3) beschriebenen Funktionen benutzen.

SIEHE AUCH

       ceil(3), floor(3), lrint(3), round(3), trunc(3)

KOLOPHON

       Diese  Seite  ist  Teil  der  Veröffentlichung  4.04  des Projekts Linux-man-pages. Eine Beschreibung des
       Projekts, Informationen, wie Fehler gemeldet werden können sowie die aktuelle Version dieser Seite finden
       sich unter http://www.kernel.org/doc/man-pages/.

ÜBERSETZUNG

       Die deutsche Übersetzung dieser Handbuchseite wurde von  Markus  Schmitt  <fw@math.uni-sb.de>  und  Chris
       Leick <c.leick@vollbio.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
       <debian-l10n-german@lists.debian.org>.

                                                 19. April 2015                                          RINT(3)