Scroll to navigation

rint(3) Library Functions Manual rint(3)

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. 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
nearbyint(), nearbyintf(), nearbyintl(), rint(), rintf(), rintl() Thread safety MT-Safe

PADRÕES

C11, POSIX.1-2008.

HISTÓRICO

C99, POSIX.1-2001.

NOTAS

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

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.

2 maio 2024 Linux man-pages (unreleased)