round(3)

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