lrint, lrintf, lrintl, llrint, llrintf, llrintl

Article
2017-12-18

The latest version of this topic can be found at lrint, lrintf, lrintl, llrint, llrintf, llrintl.

Rounds the specified floating-point value to the nearest integral value, by using the current rounding mode and direction.

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

Parameters

[in] x
the value to round.

Return Value

If successful, returns the rounded integral value of x.

Issue	Return
`x` is outside the range of the return type `x` = ±∞ `x` = NaN	Raises FE_INVALID and returns zero (0).

Remarks

Because C++ allows overloading, you can call overloads of lrint and llrint that take float and long double types. In a C program, lrint and llrint always take a double.

If x does not represent the floating-point equivalent of an integral value, these functions raise FE_INEXACT.

Microsoft specific: When the result is outside the range of the return type, or when the parameter is a NaN or infinity, the return value is implementation defined. The Microsoft compiler returns a zero (0) value.

Requirements

Function	C header	C++ header
`lrint`, `lrintf`, `lrintl`, `llrint`, `llrintf`, `llrintl`	<math.h>	<cmath>

For additional compatibility information, see Compatibility.

Share via