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.

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.

SUSv2 and POSIX.1-2001 contain text about overflow (which might set errno to ERANGE, or raise an FE_OVERFLOW exception). In practice, the result cannot overflow on any current machine, so this error-handling stuff was just nonsense. (More precisely, overflow can happen only when the maximum value of the exponent is smaller than the number of mantissa bits. For the IEEE-754 standard 32-bit and 64-bit floating-point numbers the maximum value of the exponent is 127 (respectively, 1023), and the number of mantissa bits including the implicit bit is 24 (respectively, 53).) This was removed in POSIX.1-2008.

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