Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

nearbyint — arredondamento segundo o modo atual

nearbyint devolve um valor inteiro do tipo double de acordo com a direção de arredondamento atual, sem gerar a exceção de inexatidão.

Versão: C23; repository compiler flag, production runtime not attested

Sintaxe

#include <math.h>
double nearbyint(double x);

nearbyint(x) de <math.h> devolve um valor inteiro representado como double, e não como um tipo inteiro. Utiliza a direção de arredondamento atual.

Ao contrário de rint, não gera a exceção de inexatidão (FE_INEXACT); isso não significa que apague uma indicação já existente. Por outro lado, round arredonda os casos intermédios para longe de zero, independentemente do modo atual.

O exemplo seleciona FE_DOWNWARD, pelo que -2.5 produz -3.0; em seguida, repõe o modo anterior. Requer suporte do compilador e da biblioteca para o ambiente de vírgula flutuante; uma opção de C23, por si só, não comprova esse suporte.

Exemplos

#include <fenv.h>
#include <math.h>
#include <stdio.h>

#pragma STDC FENV_ACCESS ON

int main(void)
{
#ifdef FE_DOWNWARD
    int saved = fegetround();
    if (saved < 0 || fesetround(FE_DOWNWARD) != 0)
        return 1;

    volatile double x = -2.5;
    double result = nearbyint(x);

    if (fesetround(saved) != 0)
        return 1;

    printf("%.1f\n", result);
    return 0;
#else
    return 1;
#endif
}

Resultado

-3.0

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes