rint, rintf, rintl

Artikel
06/09/2015

Rundet einen Gleitkommawert auf die nächste Ganzzahl im Gleitkommaformat.

double rint( double x );
float rint( float x );  // C++ only
long double rint( long double x );  // C++ only
float rintf( float x ); 
long double rintl( long double x );

Parameter

x
Der zu rundende Gleitkommawert.

Rückgabewert

Die rint-Funktionen geben einen Gleitkommawert zurück, der die nächste ganze Zahl zu x darstellt. Halbe Werte werden gemäß der aktuellen Einstellung für das Gleitkomma-Rundungsverhalten gerundet, wie bei den nearbyint-Funktionen. Im Gegensatz zu den nearbyint-Funktionen rufen die rint-Funktionen möglicherweise die FE_INEXACT-Gleitkommaausnahme auf, wenn sich der Wert des Ergebnisses von dem des Arguments unterscheidet. Es gibt keine Fehlerrückgabe.

Eingabe	SEH-Ausnahme	_matherr-Ausnahme
± ∞, QNAN, IND	Keine	Keine
Abbrüche	EXCEPTION_FLT_UNDERFLOW	Keine

Hinweise

Da C++ das Überladen zulässt, können Sie Überladungen von rint aufrufen, die float- und long double-Werte verwenden und zurückgeben. In einem C-Programm verwendet rint immer double und gibt diesen Wert zurück.

Anforderungen

Funktion	C-Header	C++-Header
rint, rintf, rintl	<math.h>	<cmath>

Zusätzliche Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Beispiel

// crt_rint.c
// Build with: cl /W3 /Tc crt_rint.c
// This example displays the rounded results of
// the floating-point values 2.499999, -2.499999, 
// 2.8, -2.8, 2.5 and -2.5.

#include <math.h>
#include <stdio.h>

int main( void )
{
   double x = 2.499999;
   float y = 2.8f;
   long double z = 2.5;

   printf("rint(%f) is %.0f\n", x, rint (x));
   printf("rint(%f) is %.0f\n", -x, rint (-x));
   printf("rintf(%f) is %.0f\n", y, rintf(y));
   printf("rintf(%f) is %.0f\n", -y, rintf(-y));
   printf("rintl(%Lf) is %.0Lf\n", z, rintl(z));
   printf("rintl(%Lf) is %.0Lf\n", -z, rintl(-z));
}