ИМЯ

       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(),   │ Безвредность в нитях │ MT-Safe  │
       │remainderl()                                           │                      │          │
       └───────────────────────────────────────────────────────┴──────────────────────┴──────────┘

СТАНДАРТЫ

       Функции  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 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ или более позднюю, чтобы
       узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

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