ИМЯ¶

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

БИБЛИОТЕКА¶

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

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

СТАНДАРТЫ¶

Функции 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 (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

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