Scroll to navigation

round(3) Library Functions Manual 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. 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
round(), roundf(), roundl() Thread safety MT-Safe

PADRÕES

C11, POSIX.1-2008.

HISTÓRICO

glibc 2.1. C99, POSIX.1-2001.

NOTAS

POSIX.1-2001 contains text about overflow (which might set errno to ERANGE, or raise an FE_OVERFLOW exception). In practice, the result cannot overflow on any current machine, so this error-handling stuff is just nonsense. (More precisely, overflow can happen only when the maximum value of the exponent is smaller than the number of mantissa bits. For the IEEE-754 standard 32-bit and 64-bit floating-point numbers the maximum value of the exponent is 127 (respectively, 1023), and the number of mantissa bits including the implicit bit is 24 (respectively, 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)

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.

2 maio 2024 Linux man-pages (unreleased)