nearbyint, nearbyintf, nearbyintl

Redondea el valor de punto flotante especificado en un entero y devuelve ese valor con un formato de punto flotante.

Sintaxis

double nearbyint( double x );
float nearbyintf( float x );
long double nearbyintl( long double x );
#define nearbyint( X ) // Requires C11 or higher

float nearbyint( float x ); //C++ only
long double nearbyint( long double x ); //C++ only

Parámetros

x
Valor que se redondea.

Valor devuelto

Si se ejecuta correctamente, devuelve x, redondeado al entero más cercano, utilizando el formato de redondeo actual tal y como indica fegetround. De lo contrario, es posible que la función devuelva uno de los siguientes valores:

Problema	Return
x = ±INFINITY	±INFINITY, sin modificar
x = ±0	±0, sin modificar
x = NaN	NaN

Los errores no se notifican a través _matherrde ; en concreto, esta función no notifica ninguna FE_INEXACT excepción.

Comentarios

La principal diferencia entre esta función y rint es que esta función no genera la excepción de punto flotante inexacto.

Dado que los valores de punto flotante máximos son enteros exactos, esta función nunca se desbordará por sí misma, sino que la salida podría desbordar el valor devuelto, según la versión de la función que use.

Puesto que C++ permite las sobrecargas, es posible llamar a las sobrecargas de nearbyint que toman y devuelven los parámetros float o long double. En un programa de C, a menos que use la <macro tgmath.h> para llamar a esta función, nearbyint siempre toma dos valores dobles y devuelve un valor doble.

Si usa la macro <tgmath.h>nearbyint(), el tipo del argumento determina qué versión de la función se selecciona. Consulte Matemáticas de tipo genérico para obtener más información.

De manera predeterminada, el estado global de esta función está limitado a la aplicación. Para cambiar este comportamiento, consulte Estado global en CRT.

Requisitos

Función	Encabezado C	Encabezado C++
nearbyint, nearbyintf, nearbyintl	<math.h>	<cmath> o <math.h>
nearbyintMacro	<tgmath.h>

Para obtener más información sobre compatibilidad, consulte Compatibilidad.

Consulte también

Referencia de función alfabética
Compatibilidad con matemáticas y punto flotante