remainderl - функция получения
remainderl(3)
функция получения
Other Alias
drem, dremf, dreml, remainder, remainderf
ОБЗОР
#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.
ПРИМЕР
Вызов «remainder(29.0, 3.0)» возвращает -1.
