nearbyint, nearbyintf, nearbyintl

매개변수

반환값

arg 에 가장 가까운 정수 값을 현재 반올림 모드 에 따라 반환합니다.

오류 처리

이 함수는 math_errhandling 에 지정된 어떤 오류에도 영향을 받지 않습니다.

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

• FE_INEXACT 는 절대 발생하지 않습니다.
• 만약 arg 가 ±∞이면, 수정 없이 그대로 반환됩니다.
• 만약 arg 가 ±0이면, 수정 없이 그대로 반환됩니다.
• 만약 arg 가 NaN이면, NaN이 반환됩니다.

참고 사항

nearbyint 와 rint 사이의 유일한 차이점은 nearbyint 가 절대 FE_INEXACT 를 발생시키지 않는다는 것입니다.

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

현재 반올림 모드가 FE_TONEAREST 인 경우, 이 함수는 중간값에서 짝수로 반올림합니다 ( rint 와 유사하지만 round 와는 다릅니다).

예제

#include <fenv.h>
#include <math.h>
#include <stdio.h>
int main(void)
{
// #pragma STDC FENV_ACCESS ON
    fesetround(FE_TONEAREST);
    printf("rounding to nearest:\nnearbyint(+2.3) = %+.1f  ", nearbyint(2.3));
    printf("nearbyint(+2.5) = %+.1f  ", nearbyint(2.5));
    printf("nearbyint(+3.5) = %+.1f\n", nearbyint(3.5));
    printf("nearbyint(-2.3) = %+.1f  ", nearbyint(-2.3));
    printf("nearbyint(-2.5) = %+.1f  ", nearbyint(-2.5));
    printf("nearbyint(-3.5) = %+.1f\n", nearbyint(-3.5));
    fesetround(FE_DOWNWARD);
    printf("rounding down: \nnearbyint(+2.3) = %+.1f  ", nearbyint(2.3));
    printf("nearbyint(+2.5) = %+.1f  ", nearbyint(2.5));
    printf("nearbyint(+3.5) = %+.1f\n", nearbyint(3.5));
    printf("nearbyint(-2.3) = %+.1f  ", nearbyint(-2.3));
    printf("nearbyint(-2.5) = %+.1f  ", nearbyint(-2.5));
    printf("nearbyint(-3.5) = %+.1f\n", nearbyint(-3.5));
    printf("nearbyint(-0.0) = %+.1f\n", nearbyint(-0.0));
    printf("nearbyint(-Inf) = %+.1f\n", nearbyint(-INFINITY));
}

rounding to nearest:
nearbyint(+2.3) = +2.0  nearbyint(+2.5) = +2.0  nearbyint(+3.5) = +4.0
nearbyint(-2.3) = -2.0  nearbyint(-2.5) = -2.0  nearbyint(-3.5) = -4.0
rounding down:
nearbyint(+2.3) = +2.0  nearbyint(+2.5) = +2.0  nearbyint(+3.5) = +3.0
nearbyint(-2.3) = -3.0  nearbyint(-2.5) = -3.0  nearbyint(-3.5) = -4.0
nearbyint(-0.0) = -0.0
nearbyint(-Inf) = -inf

참고문헌

참고 항목