rint(3)

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

    Requisitos de macro de teste de recursos para o glibc (consulte feature_test_macros(7)):

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).
Interface | Atributo | Valor
nearbyint(), nearbyintf(), nearbyintl(), rint(), rintf(), rintl() | Thread safety | MT-Safe

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 (https://www.gnu.org/licenses/gpl-3.0.html) 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 (debian-l10n-portuguese@lists.debian.org).