ИМЯ¶

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

БИБЛИОТЕКА¶

Math library (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);

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).

СТАНДАРТЫ¶

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>

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

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