lrint, lrintf, lrintl, llrint, llrintf, llrintl

Rundet den angegebenen Gleitkommawert auf den nächsten ganzzahligen Wert mit dem aktuellen Rundungsmodus und Richtung.

Syntax

long int lrint(
   double x
);

long int lrint(
   float x
); //C++ only

long int lrint(
   long double x
); //C++ only

long int lrintf(
   float x
);

long int lrintl(
   long double x
);

long long int llrint(
   double x
);

long long int llrint(
   float x
); //C++ only

long long int llrint(
   long double x
); //C++ only

long long int llrintf(
   float x
);

long long int llrintl(
   long double x
);

#define lrint(X) // Requires C11 or higher

Parameter

x
Hierbei handelt es sich um den zu rundenden Wert.

Rückgabewert

Bei Erfolg wird der gerundete Integralwert von x zurückgegeben.

Problem	Return
x liegt außerhalb des Bereichs des Rückgabetyps. x = ±INF x = NaN	Löst FE_INVALID null aus und gibt null (0) zurück.

Hinweise

Da C++ eine Überladung zulässt, können Sie Überladungen aufrufen lrint und diese übernehmen float und llrintlong double typen. In einem C-Programm, es sei denn, Sie verwenden das <Makro tgmath.h> , um diese Funktion aufzurufen, lrint und llrint nehmen Sie immer einen double.

Wenn Sie das <Makro tgmath.h>llrint() verwenden, bestimmt der Typ des Arguments, welche Version der Funktion ausgewählt ist. Ausführliche Informationen finden Sie unter "Typgenerika" .

Wenn x die Gleitkomma-Entsprechung eines integralen Werts nicht darstellt, lösen FE_INEXACTdiese Funktionen aus.

Microsoft-spezifisch: Wenn das Ergebnis außerhalb des Bereichs des Rückgabetyps liegt oder wenn der Parameter ein NaN oder unendlich ist, wird der Rückgabewert definiert. Der Microsoft-Compiler gibt den Wert 0 (null) zurück.

Standardmäßig gilt der globale Zustand dieser Funktion für die Anwendung. Informationen zum Ändern dieses Verhaltens finden Sie im Global state in the CRT.

Anforderungen

Funktion	C-Header	C++-Header
lrint, lrintf, lrintl, llrint, llrintf, llrintl	<math.h>	<cmath>
lrint-Makro	<tgmath.h>

Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität.

Siehe auch

Alphabetische Funktionsreferenz