rint, rintf, rintl, lrint, lrintf, lrintl, llrint, llrintf, llrintl

매개변수

반환값

오류가 발생하지 않으면, arg 에 가장 가까운 정수 값이 현재 반올림 모드 에 따라 반환됩니다.

오류 처리

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

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

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

rint 함수의 경우:

• 만약 arg 가 ±∞이면, 수정 없이 그대로 반환됩니다.
• 만약 arg 가 ±0이면, 수정 없이 그대로 반환됩니다.
• 만약 arg 가 NaN이면, NaN이 반환됩니다.

lrint 및 llrint 함수의 경우:

• arg 가 ±∞인 경우, FE_INVALID 가 발생하고 구현 정의 값이 반환됩니다.
• 반올림 결과가 반환 타입의 범위를 벗어나는 경우, FE_INVALID 가 발생하고 구현 정의 값이 반환됩니다.
• arg 가 NaN인 경우, FE_INVALID 가 발생하고 구현 정의 값이 반환됩니다.

참고 사항

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

math_errhandling 에 명시된 바와 같이, FE_INEXACT 는 정수가 아닌 유한 값을 반올림할 때 rint 에 의해 발생할 수 있습니다(IEEE 부동 소수점 플랫폼이 아닌 경우에는 필수 사항이 아닙니다).

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

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

현재 반올림 모드가...

• FE_DOWNWARD 인 경우, rint 는 floor 와 동일합니다.
• FE_UPWARD 인 경우, rint 는 ceil 와 동일합니다.
• FE_TOWARDZERO 인 경우, rint 는 trunc 와 동일합니다.
• FE_TONEAREST 인 경우, rint 는 round 와 달리 중간값의 경우 0에서 멀어지는 방향이 아닌 짝수로 반올림합니다.

예제

#include <fenv.h>
#include <limits.h>
#include <math.h>
#include <stdio.h>
int main(void)
{
#pragma STDC FENV_ACCESS ON
    fesetround(FE_TONEAREST);
    printf("rounding to nearest (halfway cases to even):\n"
           "rint(+2.3) = %+.1f  ", rint(2.3));
    printf("rint(+2.5) = %+.1f  ", rint(2.5));
    printf("rint(+3.5) = %+.1f\n", rint(3.5));
    printf("rint(-2.3) = %+.1f  ", rint(-2.3));
    printf("rint(-2.5) = %+.1f  ", rint(-2.5));
    printf("rint(-3.5) = %+.1f\n", rint(-3.5));
    fesetround(FE_DOWNWARD);
    printf("rounding down: \nrint(+2.3) = %+.1f  ", rint(2.3));
    printf("rint(+2.5) = %+.1f  ", rint(2.5));
    printf("rint(+3.5) = %+.1f\n", rint(3.5));
    printf("rint(-2.3) = %+.1f  ", rint(-2.3));
    printf("rint(-2.5) = %+.1f  ", rint(-2.5));
    printf("rint(-3.5) = %+.1f\n", rint(-3.5));
    printf("rounding down with lrint: \nlrint(+2.3) = %ld  ", lrint(2.3));
    printf("lrint(+2.5) = %ld  ", lrint(2.5));
    printf("lrint(+3.5) = %ld\n", lrint(3.5));
    printf("lrint(-2.3) = %ld  ", lrint(-2.3));
    printf("lrint(-2.5) = %ld  ", lrint(-2.5));
    printf("lrint(-3.5) = %ld\n", lrint(-3.5));
    printf("lrint(-0.0) = %ld\n", lrint(-0.0));
    printf("lrint(-Inf) = %ld\n", lrint(-INFINITY)); // FE_INVALID raised
    // error handling
    feclearexcept(FE_ALL_EXCEPT);
    printf("rint(1.1) = %.1f\n", rint(1.1));
    if (fetestexcept(FE_INEXACT))
        puts("    FE_INEXACT was raised");
    feclearexcept(FE_ALL_EXCEPT);
    printf("lrint(LONG_MIN-2048.0) = %ld\n", lrint(LONG_MIN-2048.0));
    if (fetestexcept(FE_INVALID))
        puts("    FE_INVALID was raised");
}

rounding to nearest (halfway cases to even):
rint(+2.3) = +2.0  rint(+2.5) = +2.0  rint(+3.5) = +4.0
rint(-2.3) = -2.0  rint(-2.5) = -2.0  rint(-3.5) = -4.0
rounding down:
rint(+2.3) = +2.0  rint(+2.5) = +2.0  rint(+3.5) = +3.0
rint(-2.3) = -3.0  rint(-2.5) = -3.0  rint(-3.5) = -4.0
rounding down with lrint:
lrint(+2.3) = 2  lrint(+2.5) = 2  lrint(+3.5) = 3
lrint(-2.3) = -3  lrint(-2.5) = -3  lrint(-3.5) = -4
lrint(-0.0) = 0
lrint(-Inf) = -9223372036854775808
rint(1.1) = 1.0
    FE_INEXACT was raised
lrint(LONG_MIN-2048.0) = -9223372036854775808
    FE_INVALID was raised

참고문헌

참고 항목