std::rint, std::rintf, std::rintl, std::lrint, std::lrintf, std::lrintl

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos(C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación(C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos(C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos(C++17)

Biblioteca de apoyo de concurrencia(C++11)

Biblioteca de apoyo de ejecución(C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca numérica

Funciones matemáticas comunes
Funciones matemáticas especiales(C++17)
Constantes matemáticas(C++20)
Algoritmos básicos de álgebra lineal(C++26)
Entorno de punto flotante(C++11)
Números complejos
Arrays numéricos
Generación de números pseudoaleatorios
Operaciones de factores
gcd (C++17)
lcm (C++17)
Interpolaciones
midpoint (C++20)
lerp (C++20)
Saturación aritmética
add_sat (C++26) sub_sat (C++26) saturate_cast (C++26)	mul_sat (C++26) div_sat (C++26)
Operaciones numéricas genéricas
iota (C++11)
ranges::iota (C++23)
accumulate
inner_product
adjacent_difference
partial_sum
reduce (C++17)
transform_reduce (C++17)
inclusive_scan (C++17)
exclusive_scan (C++17)
transform_inclusive_scan (C++17)
transform_exclusive_scan (C++17)
Operaciones de bits
bit_cast (C++20)
byteswap (C++23)
has_single_bit (C++20)
bit_ceil (C++20)
bit_floor (C++20)
bit_width (C++20)
rotl (C++20)
rotr (C++20)
countl_zero (C++20)
countl_one (C++20)
countr_zero (C++20)
countr_one (C++20)
popcount (C++20)
endian (C++20)

 

Funciones matemáticas comunes

Funciones
Operaciones básicas
abs(int)labsllabsimaxabs (C++11) abs(float)fabs divldivlldivimaxdiv (C++11) fmod	remainder (C++11) remquo (C++11) fma (C++11) fmax (C++11) fmin (C++11) fdim (C++11) nannanfnanl (C++11)(C++11)(C++11)
Funciones exponenciales
exp exp2 (C++11) expm1 (C++11)	log log10 log1p (C++11) log2 (C++11)
Funciones de potencias
sqrt cbrt (C++11)	hypot (C++11) pow
Funciones trigonométricas e hiperbólicas
sin cos tan asin acos atan atan2	sinh cosh tanh asinh (C++11) acosh (C++11) atanh (C++11)

Funciones de error y gamma
erf (C++11) erfc (C++11)	lgamma (C++11) tgamma (C++11)
Operaciones de punto flotante del entero más cercano
ceil floor roundlroundllround (C++11)(C++11)(C++11)	trunc (C++11) nearbyint (C++11) rintlrintllrint (C++11)(C++11)(C++11)
Funciones de manipulación de punto flotante
ldexp scalbnscalbln (C++11)(C++11) ilogb (C++11) logb (C++11)	frexp modf nextafternexttoward (C++11)(C++11) copysign (C++11)
Clasificación/comparación
fpclassify (C++11) isfinite (C++11) isinf (C++11) isnan (C++11) isnormal (C++11) signbit (C++11)	isgreater (C++11) isgreaterequal (C++11) isless (C++11) islessequal (C++11) islessgreater (C++11) isunordered (C++11)
Constantes de macro
HUGE_VALFHUGE_VALHUGE_VALL (C++11)(C++11) INFINITY (C++11) NAN (C++11) math_errhandlingMATH_ERRNOMATH_ERREXCEPT (C++11)	FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C++11)(C++11)(C++11)(C++11)(C++11)

 

Definido en el archivo de encabezado <cmath>
float       rint (float arg ); float       rintf(float arg );	(1)	(desde C++11)
double      rint (double arg );	(2)	(desde C++11)
longdouble rint (longdouble arg ); longdouble rintl(longdouble arg );	(3)	(desde C++11)
double      rint ( TipoEntero arg );	(4)	(desde C++11)
long lrint (float arg ); long lrintf(float arg );	(5)	(desde C++11)
long lrint (double arg );	(6)	(desde C++11)
long lrint (longdouble arg ); long lrintl(longdouble arg );	(7)	(desde C++11)
long lrint ( TipoEntero arg );	(8)	(desde C++11)
longlong llrint (float arg ); longlong llrintf(float arg );	(9)	(desde C++11)
longlong llrint (double arg );	(10)	(desde C++11)
longlong llrint (longdouble arg ); longlong llrintl(longdouble arg );	(11)	(desde C++11)
longlong llrint ( TipoEntero arg );	(12)	(desde C++11)

1-3) Redondea el argumento de punto flotante arg a un valor entero (en formato de punto flotante), usando el modo de redondeo actual.

5-7, 9-11) Redondea el argumento de punto flotante arg a un valor entero usando el modo de redondeo actual.

4,8,12) Un conjunto de sobrecargas o una plantilla de función que acepta un argumento de cualquier tipo entero. Equivalente a (2,6,10), respectivamente (el argumento se convierte a double).

Parámetros

arg

-

Valor de punto flotante.

Valor de retorno

Si no ocurren errores, se devuelve el entero más cercano a arg, de acuerdo al modo de redondeo actual.

Manejo de errores

Los errores se informan como se especifica en math_errhandling.

Si el resultado de std::lrint o std::llrint está fuera del rango representable por el tipo de retorno, puede ocurrir un error de dominio o un error de rango.

Si la implementación admite la aritmética de punto flotante IEEE (IEC 60559):

Para la función std::rint:

• Si arg es +∞, se devuelve +∞.
• Si arg es -∞, se devuelve -∞.
• Si arg es +0, se devuelve +0.
• Si arg es -0, se devuelve -0.
• Si arg es NaN, se devuelve NaN.

Para las funciones std::lrint y std::llrint:

• Si arg es +∞ o -∞, se genera FE_INVALID y se devuelve un valor definido por la implementación.
• Si el resultado del redondeo está fuera del rango del tipo de retorno, se genera FE_INVALID y se devuelve un valor definido por la implementación.
• Si arg es NaN, se genera FE_INVALID y se devuelve un valor definido por la implementación.

Notas

POSIX especifica que todos los casos donde std::lrint o std::llrint generen FE_INEXACT sean errores de dominio.

Como se especifica en math_errhandling, se puede generar FE_INEXACT (pero no es obligatorio que lo sea en plataformas de punto flotante no IEEE) por std::rint al redondear un valor no entero finito.

La única diferencia entre std::rint y std::nearbyint es que std::nearbyint nunca genera FE_INEXACT.

Los valores de punto flotante representables más grandes son enteros exactos en todos los formatos de punto flotante estándar, así que std::rint nunca se desborda por sí misma; sin embargo, el resultado puede desbordar a cualquier tipo entero (incluyendo a std::intmax_t), cuando se almacena en una variable entera.

Si el modo de redondeo actual es:

• FE_DOWNWARD, entonces std::rint es equivalente a std::floor;
• FE_UPWARD, entonces std::rint es equivalente a std::ceil;
• FE_TOWARDZERO, entonces std::rint es equivalente a std::trunc;
• FE_TONEAREST, entonces std::rint difiere de std::round en que casos intermedios se redondean a par en lugar de lejos de cero.

Ejemplo

Ejecuta este código

#include <iostream>#include <cmath>#include <cfenv>#include <climits>   int main(){#pragma STDC FENV_ACCESS ONstd::fesetround(FE_TONEAREST);std::cout<<"redondeando al más cercano (casos intermedios a par):\n"<<"rint(+2.3) = "<< std::rint(2.3)<<" rint(+2.5) = "<< std::rint(2.5)<<" rint(+3.5) = "<< std::rint(3.5)<<'\n'<<"rint(-2.3) = "<< std::rint(-2.3)<<" rint(-2.5) = "<< std::rint(-2.5)<<" rint(-3.5) = "<< std::rint(-3.5)<<'\n';   std::fesetround(FE_DOWNWARD);std::cout<<"redondeando hacia abajo:\n"<<"rint(+2.3) = "<< std::rint(2.3)<<" rint(+2.5) = "<< std::rint(2.5)<<" rint(+3.5) = "<< std::rint(3.5)<<'\n'<<"rint(-2.3) = "<< std::rint(-2.3)<<" rint(-2.5) = "<< std::rint(-2.5)<<" rint(-3.5) = "<< std::rint(-3.5)<<'\n'<<"redondeando hacia abajo con lrint\n"<<"lrint(+2.3) = "<< std::lrint(2.3)<<" lrint(+2.5) = "<< std::lrint(2.5)<<" lrint(+3.5) = "<< std::lrint(3.5)<<'\n'<<"lrint(-2.3) = "<< std::lrint(-2.3)<<" lrint(-2.5) = "<< std::lrint(-2.5)<<" lrint(-3.5) = "<< std::lrint(-3.5)<<'\n';   std::cout<<"lrint(-0.0) = "<< std::lrint(-0.0)<<'\n'<<"lrint(-Inf) = "<< std::lrint(-INFINITY)<<'\n';   // control de erroresstd::feclearexcept(FE_ALL_EXCEPT);std::cout<<"std::rint(0.1) = "<< std::rint(.1)<<'\n';if(std::fetestexcept(FE_INEXACT))std::cout<<" Se generó FE_INEXACT\n";   std::feclearexcept(FE_ALL_EXCEPT);std::cout<<"std::lrint(LONG_MIN-2048.0) = "<< std::lrint(LONG_MIN-2048.0)<<'\n';if(std::fetestexcept(FE_INVALID))std::cout<<" Se generó FE_INVALID\n";}

Posible salida:

redondeando al más cercano (casos intermedios a par): rint(+2.3) = 2 rint(+2.5) = 2 rint(+3.5) = 4 rint(-2.3) = -2 rint(-2.5) = -2 rint(-3.5) = -4 redondeando hacia abajo: rint(+2.3) = 2 rint(+2.5) = 2 rint(+3.5) = 3 rint(-2.3) = -3 rint(-2.5) = -3 rint(-3.5) = -4 redondeando hacia abajo con lrint lrint(+2.3) = 2 lrint(+2.5) = 2 lrint(+3.5) = 3 lrint(-2.3) = -3 lrint(-2.5) = -3 lrint(-3.5) = -4 lrint(-0.0) = 0 lrint(-Inf) = -9223372036854775808 std::rint(0.1) = 0 Se generó FE_INEXACT std::lrint(LONG_MIN-2048.0) = -9223372036854775808 Se generó FE_INVALID

Véase también

trunctruncftruncl (C++11)(C++11)(C++11)	Entero más cercano no mayor en magnitud que el valor dado (función)
nearbyintnearbyintfnearbyintl (C++11)(C++11)(C++11)	Entero más cercano usando el modo de redondeo actual (función)
fegetroundfesetround (C++11)(C++11)	Obtiene o establece la dirección redondeo (función)
Documentación de C para rint