rint, rintf, rintl

Arredonda um valor de ponto flutuante para o inteiro mais próximo no formato de ponto flutuante.

Sintaxe

double rint( double x );
float rintf( float x );
long double rintl( long double x );
#define rint(X) // Requires C11 or higher

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

Parâmetros

x
O valor do ponto flutuante a ser arredondado.

Valor retornado

As funções rint retornam um valor de ponto flutuante que representa o inteiro mais próximo a x. Valores decimais são arredondados de acordo com a configuração atual do modo de arredondamento do ponto flutuante, assim como as funções nearbyint. Diferentemente das funções nearbyint, as funções rint podem resultar na exceção de ponto flutuante FE_INEXACT se o resultado tiver um valor diferente do argumento. Não há retorno de erro.

Entrada	Exceção SEH	Exceção _matherr
± INF, QNaN, IND	nenhum	nenhum
Desnormalizado	EXCEPTION_FLT_UNDERFLOW	nenhum

Comentários

Como C++ permite sobrecargas, é possível chamar sobrecargas de rint que tomam e retornam valores de float e long double. Em um programa C, a menos que esteja usando a macro <tgmath.h> para chamar essa função, rint sempre recebe e retorna um double.

Se você usa a macro <tgmath.h>rint(), o tipo do argumento determina qual versão da função será selecionada. Confira Matemática do tipo genérico para obter detalhes.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, confira Estado global no CRT.

Requisitos

Função	Cabeçalho C	Cabeçalho C++
rint, rintf, rintl	<math.h>	<cmath>
Macro rint	<tgmath.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

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

rint(2.499999) is 2
rint(-2.499999) is -2
rintf(2.800000) is 3
rintf(-2.800000) is -3
rintl(2.500000) is 3
rintl(-2.500000) is -3

Confira também

Suporte matemático e de ponto flutuante
ceil, ceilf, ceill
floor, floorf, floorl
fmod, fmodf
lrint, lrintf, lrintl, llrint, llrintf, , llrintl
lround, lroundf, lroundl, llround, llroundf, , llroundl
nearbyint, nearbyintf, nearbyintl
rint