NOME¶

nearbyint, nearbyintf, nearbyintl, rint, rintf, rintl - arredonda para o inteiro mais próximo

BIBLIOTECA¶

Biblioteca matemática (libm, -lm)

SINOPSE¶

#include <math.h>

double nearbyint(double x);
float nearbyintf(float x);
long double nearbyintl(long double x);

double rint(double x);
float rintf(float x);
long double rintl(long double x);

nearbyint(), nearbyintf(), nearbyintl():

    _POSIX_C_SOURCE >= 200112L || _ISOC99_SOURCE

rint():

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L


        || _XOPEN_SOURCE >= 500


        || /* Desde o glibc 2.19: */ _DEFAULT_SOURCE


        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

rintf(), rintl():

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L


        || /* Desde o glibc 2.19: */ _DEFAULT_SOURCE


        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

DESCRIÇÃO¶

As funções nearbyint(), nearbyintf() e nearbyintl() arredondam seus argumentos para um valor inteiro no formato de ponto flutuante, usando a direção de arredondamento atual (veja fesetround(3)) e sem gerar a exceção inexact. Quando a direção de arredondamento atual é para o mais próximo, essas funções arredondam as casas intermediárias para o número inteiro par, de acordo com IEEE-754.

As funções rint(), rintf() e rintl() fazem o mesmo, mas geram uma exceção inexact (FE_INEXACT, verificável via fetestexcept(3)) quando o resultado difere em valor do argumento.

VALOR DE RETORNO¶

Estas funções retornar um valor inteiro arredondado.

Se x é integral, +0, -0, NaN ou infinito, o próprio x é retornado.

ERROS¶

Ocorre nenhum erro. POSIX.1-2001 documenta um erro de intervalo para estouros, mas consulte NOTAS.

ATRIBUTOS¶

Para uma explicação dos termos usados nesta seção, consulte attributes(7).

PADRÕES¶

C11, POSIX.1-2008.

HISTÓRICO¶

C99, POSIX.1-2001.

NOTAS¶

SUSv2 e POSIX.1-2001 contêm um texto sobre 'overflow' ou estouro de pilha (que pode definir errno para ERANGE ou levantar uma exceção FE_OVERFLOW). Na prática, o resultado não pode causar 'overflow' em qualquer máquina, assim esta coisa de manipulação de erros não tem sentido. (Mais precisamente, 'overflow' somente ocorre quando o valor máximo do expoente é menor que o número de bits da mantissa. Para números de ponto flutuante de 32 e 64 bits do padrão IEEE-754, o valor máximo do expoente é 127 (respectivamente, 1023) e o de bits da mantissa incluindo o bit implícito é 24 (respectivamente, 53)).

Se você deseja armazenar o valor arredondado em um tipo inteiro, provavelmente desejará usar uma das funções descritas em lrint(3).

VEJA TAMBÉM¶

ceil(3), floor(3), lrint(3), round(3), trunc(3)

TRADUÇÃO¶

A tradução para português brasileiro desta página man foi criada por Marcelo Pereira da Silva <marcelo@pereira.com>, André Luiz Fassone <lonely_wolf@ig.com.br> e Rafael Fontenelle <rafaelff@gnome.org>.

Esta tradução é uma documentação livre; leia a Licença Pública Geral GNU Versão 3 ou posterior para as condições de direitos autorais. Nenhuma responsabilidade é aceita.

Se você encontrar algum erro na tradução desta página de manual, envie um e-mail para a lista de discussão de tradutores.