NOME

       round, roundf, roundl - arredonda para o número inteiro mais próximo, distante de zero

BIBLIOTECA

       Biblioteca matemática (libm, -lm)

SINOPSE

       #include <math.h>

       double round(double x);
       float roundf(float x);
       long double roundl(long double x);

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

       round(), roundf(), roundl():
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L

DESCRIÇÃO

       Estas  funções  arredondam x para o número inteiro mais próximo, mas parcialmente casos distantes de zero
       (independente da direção de arredondamento atual, veja fenv(3)), ao invés de  arredondar  para  o  número
       inteiro par como rint(3).

       Por exemplo, round(0.5) é 1.0 e round(-0.5) é -1.0.

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   │
       ├─────────────────────────────────────────────────────────────────────────────┼───────────────┼─────────┤
       │ round(), roundf(), roundl()                                                 │ Thread safety │ MT-Safe │
       └─────────────────────────────────────────────────────────────────────────────┴───────────────┴─────────┘

PADRÕES

       C11, POSIX.1-2008.

HISTÓRICO

       glibc 2.1.  C99, POSIX.1-2001.

       POSIX.1-2001 contêm um texto sobre "overflow" (que pode definir errno para ERANGE ou levantar uma exceção
       FE_OVERFLOW). Na prática, o resultado não pode causar um "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 de um expoente é menor que o número de bits da mantissa. Para, o padronização IEEE-754, os números
       em ponto flutuante de 32 bits e 64 bits o valor máximo do expoente é  128  (respectivamente,  1024)  e  o
       número de bits da mantissa é 24 (respectivamente, 53)). Isso foi removido no POSIX.1-2008.

       Se  você  deseja  armazenar  o  valor  arredondado  em um tipo inteiro, provavelmente deseja usar uma das
       funções descritas em lround(3).

VEJA TAMBÉM

       ceil(3), floor(3), lround(3), nearbyint(3), rint(3), trunc(3)

TRADUÇÃO

       A tradução para português brasileiro desta página man foi criada por Mila <misfit@linuxbr.com.br>,  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                                         round(3)