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

       C99, POSIX.1-2001, POSIX.1-2008.

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.

Linux man-pages 6.03                            5 fevereiro 2023                                         rint(3)