Other Alias
dremf, dreml, remainder, remainderf, remainderlОБЗОР
#include <math.h>
/* Версии C99 */
double remainder(double x, double y);
float remainderf(float x, float y);
long double remainderl(long double x, long double y);
/* Устаревшие синонимы */
double drem(double x, double y);
float dremf(float x, float y);
long double dreml(long double x, long double y);
Компонуется при указании параметра -lm.
Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):
remainder():
-
_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE >= 500 || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED || _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L;
или cc -std=c99
remainderf(), remainderl():
-
_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE
|| _POSIX_C_SOURCE >= 200112L;
или cc -std=c99
drem(), dremf(), dreml():
- _SVID_SOURCE || _BSD_SOURCE
ОПИСАНИЕ
Данные функции вычисляют остаток от деления x на y. Возвращаемое значение равно x-n*y, где n равно значению x / y, округлённому до ближайшего целого. Если абсолютное значение x-n*y равно 0.5, то n выбирается целым.Эти функции не подвержены действующему режиму округления (смотрите fenv(3)).
Функция drem() выполняет тоже самое.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ
При успешном выполнении данные функции возвращают остаток x-n*y в виде значения с плавающей запятой. Если возвращаемое значение равно 0, то оно имеет знак x.Если значение x или y равно NaN, будет возвращено NaN.
Если x стремится к бесконечности и y не равно NaN, то будет сгенерирована ошибка выхода за пределы области, а в качестве результата будет возвращено NaN.
Если y равно 0 и x не равно NaN, то будет сгенерирована ошибка выхода за пределы области, а в качестве результата будет возвращено NaN.
ОШИБКИ
Смотрите math_error(7), чтобы определить возникшую ошибку при вызове этих функций.Могут возникать следующие ошибки:
- Ошибка области: x стремится к бесконечности, а y не равно NaN
- Возникает исключение неправильной плавающей запятой (FE_INVALID).
- В этом случае функции не изменяют errno.
- Ошибка области: y равно 0 Значение errno устанавливается в EDOM. Возникает исключение неправильной плавающей точки (FE_INVALID).
АТРИБУТЫ
Описание терминов данного раздела смотрите в attributes(7).| Интерфейс | Атрибут | Значение |
|
drem(),
dremf(),
dreml(),
remainder(), remainderf(), remainderl() | безвредность в нитях | безвредно (MT-Safe) |
СООТВЕТСТВИЕ СТАНДАРТАМ
Функции remainder(), remainderf() и remainderl() определены в C99 и POSIX.1-2001 и POSIX.1-2008.Функция drem() появилась из 4.3BSD. Варианты функций dremf() и dreml() с типами float и long double есть в некоторых системах, таких как Tru64 и glibc2. Не используйте эти функции вместо remainder() и ей подобным.
ДЕФЕКТЫ
Вызов
remainder(nan(""), 0);
возвращает NaN, как и ожидается, но некорректно приводит к ошибке области; на самом деле, просто должно возвращаться NaN.