ИМЯ

       drem,  dremf,  dreml,  remainder,  remainderf,  remainderl - функция получения остатка от деления числа с
       плавающей запятой

LIBRARY

       Math library (libm, -lm)

СИНТАКСИС

       #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);

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

       remainder():
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
               || _XOPEN_SOURCE >= 500
               || /* начиная с glibc 2.19: */ _DEFAULT_SOURCE
               || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

       remainderf(), remainderl():
           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
               || /* начиная с glibc 2.19: */ _DEFAULT_SOURCE
               || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

       drem(), dremf(), dreml():
           /* начиная с glibc 2.19: */ _DEFAULT_SOURCE
               || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_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
              Значение errno  устанавливается  в  EDOM  (но  см.  ДЕФЕКТЫ).  Возникает  исключение  неправильной
              плавающей запятой (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()  и  ей
       подобным.

ДЕФЕКТЫ

       До glibc 2.15 вызов

           remainder(nan(""), 0);

       возвращал  NaN,  как  и ожидается, но некорректно приводит к ошибке области; Начиная с glibc 2.15, просто
       возвращается NaN (т. е., без ошибки области).

       До glibc 2.15, errno не присваивалось EDOM пр ошибке области, возникающей когда x — бесконечность, а y не
       равно NaN.

ПРИМЕРЫ

       Вызов «remainder(29.0, 3.0)» возвращает -1.

СМ. ТАКЖЕ

       div(3), fmod(3), remquo(3)

ПЕРЕВОД

       Русский перевод этой  страницы  руководства  был  сделан  aereiae  <aereiae@gmail.com>,  Azamat  Hackimov
       <azamat.hackimov@gmail.com>,     Dmitriy     S.     Seregin     <dseregin@59.ru>,     Katrin     Kutepova
       <blackkatelv@gmail.com>,  Lockal  <lockalsash@gmail.com>,  Yuri  Kozlov   <yuray@komyakino.ru>,   Баринов
       Владимир и Иван Павлов <pavia00@gmail.com>

       Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3
       или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

       Если  вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо
       на man-pages-ru-talks@lists.sourceforge.net.

Linux man-pages 6.03                            5 февраля 2023 г.                                   remainder(3)