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 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)).
       Isso foi removido em 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 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.9.1                             16 junho 2024                                          rint(3)