remquo(3) остаток и неполное частное

Other Alias

remquof, remquol

ОБЗОР

#include <math.h>


double remquo(double x, double y, int *quo);
float remquof(float x, float y, int *quo);
long double remquol(long double x, long double y, int *quo);

Компонуется при указании параметра -lm.

Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

remquo(), remquof(), remquol():

_XOPEN_SOURCE >= 600 || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L;
или cc -std=c99

ОПИСАНИЕ

Эти функции вычисляют остаток и неполное частное при делении x на y. Неполное частное сохраняется через указатель quo. Остаток возвращается как результат функции.

Значение остатка тоже, что и при вычислении функцией remainder(3).

Значение, сохраняемое по указателю quo, имеет знак x / y и сохраняет от частного не менее 3 младших бит.

Например, remquo(29.0, 3.0) возвращает -1.0 и может сохранить 2. Заметим, что реальный остаток может не поместиться в integer.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

При успешном выполнении данные функции возвращают тоже значение, что и аналогичные функции, описанные в remainder(3).

Если значение x или y равно NaN, будет возвращено NaN.

Если x стремится к бесконечности и y не равно NaN, то будет сгенерирована ошибка выхода за пределы области, а в качестве результата будет возвращено NaN.

Если y равно 0 и x не равно NaN, то будет сгенерирована ошибка выхода за пределы области, а в качестве результата будет возвращено NaN.

ОШИБКИ

Смотрите math_error(7), чтобы определить возникшую ошибку при вызове этих функций.

Могут возникать следующие ошибки:

Ошибка области: x стремится к бесконечности или y равно 0, и другой аргумент не равен NaN.
Возникает исключение неправильной плавающей запятой (FE_INVALID).

Эти функции не изменяют errno.

ВЕРСИИ

Эти функции впервые появились в glibc 2.1.

АТРИБУТЫ

Описание терминов данного раздела смотрите в attributes(7).
ИнтерфейсАтрибутЗначение
remquo(), remquof(), remquol() безвредность в нитяхбезвредно (MT-Safe)

СООТВЕТСТВИЕ СТАНДАРТАМ

C99, POSIX.1-2001, POSIX.1-2008.