remainder, remainderf, remainderl

Остаток от деления с плавающей запятой по стандарту IEEE операции x / y , вычисляемый этой функцией, точно равен значению x - n * y , где значение n является целым числом, ближайшим к точному значению x / y . Когда |n-x/y| = ½ , значение n выбирается чётным.

В отличие от fmod() , возвращаемое значение не гарантированно имеет тот же знак, что и x .

Если возвращаемое значение равно ​ 0 ​ , оно будет иметь тот же знак, что и x .

Параметры

Возвращаемое значение

В случае успеха возвращает остаток от деления с плавающей запятой в формате IEEE x / y как определено выше.

Если происходит ошибка домена, возвращается значение, определяемое реализацией (NaN, если поддерживается).

Если происходит ошибка диапазона из-за потери значимости (underflow), возвращается корректный результат.

Если y равен нулю, но ошибка домена не возникает, возвращается ноль.

Обработка ошибок

Ошибки сообщаются, как указано в math_errhandling .

Ошибка домена может возникнуть, если y равен нулю.

Если реализация поддерживает арифметику с плавающей запятой IEEE (IEC 60559),

• Текущий режим округления не оказывает влияния.
• FE_INEXACT никогда не устанавливается, результат всегда точный.
• Если x равен ±∞ и y не является NaN, возвращается NaN и устанавливается FE_INVALID .
• Если y равен ±0 и x не является NaN, возвращается NaN и устанавливается FE_INVALID .
• Если любой из аргументов является NaN, возвращается NaN.

Примечания

POSIX требует возникновения ошибки домена, если x является бесконечным или y равен нулю.

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

Ссылки

Смотрите также