- bookworm 4.18.1-1
- bookworm-backports 4.21.0-2~bpo12+1
- testing 4.21.0-2
- unstable 4.21.0-2
remainder(3) | Library Functions Manual | remainder(3) |
ИМЯ¶
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);
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(), remainderl() | Безвредность в нитях | MT-Safe |
СТАНДАРТЫ¶
Функции 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.
СМ. ТАКЖЕ¶
ПЕРЕВОД¶
Русский перевод этой страницы руководства был сделан 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 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.
5 февраля 2023 г. | Linux man-pages 6.03 |