fmod, fmodf, fmodl

이 함수로 계산된 나눗셈 연산의 부동 소수점 나머지는 정확히 x / y 의 값이며, 여기서 n 은 소수 부분이 잘린 x / y 입니다.

반환된 값은 x 와 동일한 부호를 가지며 크기는 y 보다 작거나 같습니다.

매개변수

반환값

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

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

언더플로우로 인해 범위 오류가 발생하는 경우, 올바른 결과(반올림 후)가 반환됩니다.

오류 처리

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

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

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

• 만약 x 가 ±0이고 y 가 0이 아니면, ±0이 반환됩니다.
• 만약 x 가 ±∞이고 y 가 NaN이 아니면, NaN이 반환되고 FE_INVALID 가 발생합니다.
• 만약 y 가 ±0이고 x 가 NaN이 아니면, NaN이 반환되고 FE_INVALID 가 발생합니다.
• 만약 y 가 ±∞이고 x 가 유한값이면, x 가 반환됩니다.
• 만약 두 인수 중 하나가 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 의 범위를 벗어납니다.

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

double fmod(double x, double y)
{
#pragma STDC FENV_ACCESS ON
    double result = remainder(fabs(x), (y = fabs(y)));
    if (signbit(result))
        result += y;
    return copysign(result, x);
}

예제

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

fmod(+5.1, +3.0) = 2.1
fmod(-5.1, +3.0) = -2.1
fmod(+5.1, -3.0) = 2.1
fmod(-5.1, -3.0) = -2.1
fmod(+0.0, 1.0) = 0.0
fmod(-0.0, 1.0) = -0.0
fmod(+5.1, Inf) = 5.1
fmod(+5.1, 0) = nan
    FE_INVALID raised

참고문헌

참고 항목