round, roundf, roundl, lround, lroundf, lroundl, llround, llroundf, llroundl

매개변수

반환값

오류가 발생하지 않으면, arg 에 가장 가까운 정수 값(중간 값은 0에서 멀어지는 방향으로 반올림)이 반환됩니다.

반환값

인수

도메인 오류가 발생하면 구현에서 정의한 값이 반환됩니다.

오류 처리

오류는 math_errhandling 에 명시된 대로 보고됩니다.

lround 또는 llround 의 결과가 반환 타입으로 표현 가능한 범위를 벗어나는 경우, 도메인 오류 또는 범위 오류가 발생할 수 있습니다.

구현체가 IEEE 부동 소수점 연산(IEC 60559)을 지원하는 경우:

round , roundf , roundl 함수의 경우:

• 현재 반올림 모드 는 영향을 미치지 않습니다.
• arg 가 ±∞인 경우, 수정 없이 그대로 반환됩니다.
• arg 가 ±0인 경우, 수정 없이 그대로 반환됩니다.
• arg 가 NaN인 경우, NaN이 반환됩니다.

lround 및 llround 함수 계열의 경우:

• FE_INEXACT 는 절대 발생하지 않습니다.
• 현재 반올림 모드 는 영향을 미치지 않습니다.
• arg 가 ±∞인 경우, FE_INVALID 이 발생하고 구현 정의 값이 반환됩니다.
• 반올림 결과가 반환 타입의 범위를 벗어나는 경우, FE_INVALID 이 발생하고 구현 정의 값이 반환됩니다.
• arg 가 NaN인 경우, FE_INVALID 이 발생하고 구현 정의 값이 반환됩니다.

참고 사항

FE_INEXACT 는 정수가 아닌 유한 값을 반올림할 때 round 에 의해 (필수는 아니지만) 발생할 수 있습니다.

표준 부동 소수점 형식에서 표현 가능한 가장 큰 부동 소수점 값들은 모두 정확한 정수이므로, round 함수 자체는 절대 오버플로우를 발생시키지 않습니다; 그러나 그 결과를 정수 변수( intmax_t 를 포함한)에 저장할 때는 어떤 정수 타입으로도 오버플로우가 발생할 수 있습니다.

POSIX는 lround 또는 llround 가 FE_INVALID 를 발생시키는 모든 경우가 도메인 오류라고 명시합니다.

double 버전의 round 함수는 다음과 같이 구현된 것처럼 동작합니다:

#include <math.h>
#pragma STDC FENV_ACCESS ON
double round(double x)
{
    return signbit(x) ? ceil(x - 0.5) : floor(x + 0.5);
}

예제

#include <assert.h>
#include <fenv.h>
#include <float.h>
#include <limits.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
double custom_round(double x)
{
    return signbit(x) ? ceil(x - 0.5) : floor(x + 0.5);
}
void test_custom_round()
{
    const double sample[] =
    {
        0.0, 2.3, 2.5 - DBL_EPSILON, 2.5, 2.5 + DBL_EPSILON, 2.7, INFINITY
    };
    for (size_t t = 0; t < sizeof sample / sizeof(double); ++t)
        assert(round(+sample[t]) == custom_round(+sample[t]) &&
               round(-sample[t]) == custom_round(-sample[t]));
}
int main(void)
{
    // round
    printf("round(+2.3) = %+.1f  ", round(2.3));
    printf("round(+2.5) = %+.1f  ", round(2.5));
    printf("round(+2.7) = %+.1f\n", round(2.7));
    printf("round(-2.3) = %+.1f  ", round(-2.3));
    printf("round(-2.5) = %+.1f  ", round(-2.5));
    printf("round(-2.7) = %+.1f\n", round(-2.7));
    printf("round(-0.0) = %+.1f\n", round(-0.0));
    printf("round(-Inf) = %+f\n",   round(-INFINITY));
    test_custom_round();
    // lround
    printf("lround(+2.3) = %+ld  ", lround(2.3));
    printf("lround(+2.5) = %+ld  ", lround(2.5));
    printf("lround(+2.7) = %+ld\n", lround(2.7));
    printf("lround(-2.3) = %+ld  ", lround(-2.3));
    printf("lround(-2.5) = %+ld  ", lround(-2.5));
    printf("lround(-2.7) = %+ld\n", lround(-2.7));
    printf("lround(-0.0) = %+ld\n", lround(-0.0));
    printf("lround(-Inf) = %+ld\n", lround(-INFINITY)); // FE_INVALID raised
    // error handling
    feclearexcept(FE_ALL_EXCEPT);
    printf("lround(LONG_MAX+1.5) = %ld\n", lround(LONG_MAX + 1.5));
    if (fetestexcept(FE_INVALID))
        puts("    FE_INVALID was raised");
}

round(+2.3) = +2.0  round(+2.5) = +3.0  round(+2.7) = +3.0
round(-2.3) = -2.0  round(-2.5) = -3.0  round(-2.7) = -3.0
round(-0.0) = -0.0
round(-Inf) = -inf
lround(+2.3) = +2  lround(+2.5) = +3  lround(+2.7) = +3
lround(-2.3) = -2  lround(-2.5) = -3  lround(-2.7) = -3
lround(-0.0) = +0
lround(-Inf) = -9223372036854775808
lround(LONG_MAX+1.5) = -9223372036854775808
    FE_INVALID was raised

참고문헌

참고 항목