НАИМЕНОВАНИЕ

       fmod, fmodf, fmodl - функция получения остатка от деления числа с плавающей запятой

БИБЛИОТЕКА

       Математическая библиотека (libm, -lm)

ОБЗОР

       #include <math.h>

       double fmod(double x, double y);
       float fmodf(float x, float y);
       long double fmodl(long double x, long double y);

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

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

ОПИСАНИЕ

       Эти функции вычисляют остаток деления числа с плавающей запятой x на y. Возвращаемое значение: x - n * y,
       где n — частное x / y, округлённое к нулю до ближайшего целого числа.

       To  obtain the modulus, more specifically, the Least Positive Residue, you will need to adjust the result
       from fmod like so:

           z = fmod(x, y);
           if (z < 0)
                z += y;

       An alternate way to express this is with fmod(fmod(x, y) + y, y), but the second  fmod()   usually  costs
       way more than the one branch.

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

       При  успешном  выполнении  функции  возвращают  значение  x - n*y  для  некоторого  целого  n;  при  этом
       возвращаемое значение имеет тот же знак что и x, а абсолютное значение меньше абсолютного значения y.

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

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

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

       Если x равно +0 (-0) и y не равно, то возвращается +0 (-0).

ОШИБКИ

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

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

       Ошибка области: x стремится к бесконечности
              Значение errno  устанавливается  в  EDOM  (но  см.  ДЕФЕКТЫ).  Возникает  исключение  неправильной
              плавающей запятой (FE_INVALID).

       Ошибка области: y равно 0
              errno устанавливается в EDOM. Вызывается исключение неправильной плавающей точки (FE_INVALID).

АТРИБУТЫ

       Описание терминов данного раздела смотрите в attributes(7).
       ┌─────────────────────────────────────────────────────────────────────┬──────────────────────┬──────────┐
       │ Интерфейс                                                           │ Атрибут              │ Значение │
       ├─────────────────────────────────────────────────────────────────────┼──────────────────────┼──────────┤
       │ fmod(), fmodf(), fmodl()                                            │ Безвредность в нитях │ MT-Safe  │
       └─────────────────────────────────────────────────────────────────────┴──────────────────────┴──────────┘

СТАНДАРТЫ

       C11, POSIX.1-2008.

ИСТОРИЯ

       C99, POSIX.1-2001.

       Вариант, возвращающий значение типа double, также соответствует SVr4, 4.3BSD, C89.

ОШИБКИ

       Before glibc 2.10, the glibc implementation did not set errno to EDOM when a domain error occurred for an
       infinite x.

ПРИМЕРЫ

       The call fmod(372, 360) returns 348.

       The call fmod(-372, 360) returns -12.

       The call fmod(-372, -360) also returns -12.

СМОТРИТЕ ТАКЖЕ

       remainder(3)

ПЕРЕВОД

       Русский  перевод  этой  страницы  руководства  разработал(и) Azamat Hackimov <azamat.hackimov@gmail.com>,
       Dmitry   Bolkhovskikh   <d20052005@yandex.ru>,   Yuri   Kozlov    <yuray@komyakino.ru>,    Иван    Павлов
       <pavia00@gmail.com> и Kirill Rekhov <krekhov.dev@gmail.com>

       Этот  перевод является свободной программной документацией; он распространяется на условиях общедоступной
       лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html  версии  3  или
       более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

       Если  вы  обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом
       разработчику(ам)  по  его(их)  адресу(ам)  электронной  почты  или  по   адресу   списка рассылки русских
       переводчиков.

Справочные страницы Linux 6.9.1                   2 мая 2024 г.                                          fmod(3)