Provided by: manpages-pt-br-dev_4.23.1-1_all
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(), │ Thread safety │ MT-Safe │ │rintl() │ │ │ └───────────────────────────────────────────────────────────────┴───────────────┴─────────┘
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⟩.