ROUND(3)

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

SINOPSE
#include <math.h>

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

Vincule com -lm.

    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. POSIX.1-2001 documenta um erro de intervalo para estouros, mas consulte NOTAS.

VERSÕES
Estas funções apareceram pela primeira vez no glibc desde a versão 2.1.

ATRIBUTOS
Para uma explicação dos termos usados nesta seção, consulte attributes(7).
Interface | Atributo | Valor
round(), roundf(), roundl() | Thread safety | MT-Safe

DE ACORDO COM
C99, POSIX.1-2001, POSIX.1-2008.

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

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)

COLOFÃO
Esta página faz parte da versão 5.13 do projeto Linux man-pages. Uma descrição do projeto, informações sobre relatórios de bugs e a versão mais recente desta página podem ser encontradas em https://www.kernel.org/doc/man-pages/.

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