fmod(3)

НАИМЕНОВАНИЕ
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 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

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