remainder, remainderf, remainderl

이 함수에 의해 계산된 나눗셈 연산 x / y 의 IEEE 부동 소수점 나머지는 정확히 x - n * y 값입니다. 여기서 n 값은 정확한 값 x / y 에 가장 가까운 정수 값입니다. |n-x/y| = ½ 인 경우, n 값은 짝수로 선택됩니다.

fmod() 와 대조적으로, 반환된 값이 x 와 같은 부호를 가질 것이라고 보장되지 않습니다.

반환된 값이 ​ 0 ​ 인 경우, 이는 x 와 동일한 부호를 가집니다.

매개변수

반환값

성공 시, 위에서 정의된 대로 나눗셈 x / y 의 IEEE 부동 소수점 나머지를 반환합니다.

도메인 오류가 발생하면 구현에서 정의한 값이 반환됩니다(NaN을 지원하는 경우 해당 값).

언더플로우로 인해 범위 오류가 발생하면 올바른 결과가 반환됩니다.

만약 y 가 0이지만 도메인 오류가 발생하지 않는 경우, 0이 반환됩니다.

오류 처리

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

y 가 0인 경우 도메인 오류가 발생할 수 있습니다.

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

• 현재 반올림 모드 는 영향을 미치지 않습니다.
• FE_INEXACT 는 절대 발생하지 않으며, 결과는 항상 정확합니다.
• 만약 x 가 ±∞이고 y 가 NaN이 아니면, NaN이 반환되고 FE_INVALID 가 발생합니다.
• 만약 y 가 ±0이고 x 가 NaN이 아니면, NaN이 반환되고 FE_INVALID 가 발생합니다.
• 인수 중 하나라도 NaN이면, NaN이 반환됩니다.

참고 사항

POSIX는 x 가 무한대이거나 y 가 0인 경우 도메인 오류가 발생하도록 요구합니다.

fmod 는 부동 소수점 타입을 부호 없는 정수 타입으로 자동 래핑하는 데 유용하지만, remainder 는 그렇지 않습니다: ( 0.0 <= ( y = fmod ( rint ( x ) , 65536.0 ) ) ? y : 65536.0 + y ) 는 [ - 0.0 , 65535.0 ] 범위에 있으며, 이는 unsigned short 에 해당합니다. 그러나 remainder ( rint ( x ) , 65536.0 ) 는 [ - 32767.0 , + 32768.0 ] 범위에 있어 signed short 의 범위를 벗어납니다.

예제

#include <fenv.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    printf("remainder(+5.1, +3.0) = %.1f\n", remainder(5.1, 3));
    printf("remainder(-5.1, +3.0) = %.1f\n", remainder(-5.1, 3));
    printf("remainder(+5.1, -3.0) = %.1f\n", remainder(5.1, -3));
    printf("remainder(-5.1, -3.0) = %.1f\n", remainder(-5.1, -3));
    // 특수 값
    printf("remainder(-0.0, 1.0) = %.1f\n", remainder(-0.0, 1));
    printf("remainder(+5.1, Inf) = %.1f\n", remainder(5.1, INFINITY));
    // 오류 처리
    feclearexcept(FE_ALL_EXCEPT);
    printf("remainder(+5.1, 0) = %.1f\n", remainder(5.1, 0));
    if (fetestexcept(FE_INVALID))
        puts("    FE_INVALID raised");
}

remainder(+5.1, +3.0) = -0.9
remainder(-5.1, +3.0) = 0.9
remainder(+5.1, -3.0) = -0.9
remainder(-5.1, -3.0) = 0.9
remainder(+0.0, 1.0) = 0.0
remainder(-0.0, 1.0) = -0.0
remainder(+5.1, Inf) = 5.1
remainder(+5.1, 0) = -nan
    FE_INVALID raised

참고문헌

참고 항목