- bullseye-backports 4.17.0-2~bpo11+1
- testing 4.17.0-2
- unstable 4.17.0-2
NEXTAFTER(3) | Руководство программиста Linux | NEXTAFTER(3) |
ИМЯ¶
nextafter, nextafterf, nextafterl, nexttoward, nexttowardf, nexttowardl - операции над числами с плавающей запятой
СИНТАКСИС¶
#include <math.h>
double nextafter(double x, double
y);
float nextafterf(float x, float y);
long double nextafterl(long double x, long double
y);
double nexttoward(double x, long double
y);
float nexttowardf(float x, long double y);
long double nexttowardl(long double x, long double
y);
Компонуется при указании параметра -lm.
nextafter():
|| _XOPEN_SOURCE >= 500
|| /* начиная с glibc 2.19: */ _DEFAULT_SOURCE
|| /* версии glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
nextafterf(), nextafterl():
|| /* начиная с glibc 2.19: */ _DEFAULT_SOURCE
|| /* в версиях glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
nexttoward(), nexttowardf(), nexttowardl():
ОПИСАНИЕ¶
Функции nextafter(), nextafterf() и nextafterl() возвращают следующее представимое значение с плавающей запятой после x по направлению к y. Если y меньше x, то эти функции возвращают наибольшее представимое число, которое меньше x.
Если x = y, то функции возвращают y.
Функции nexttoward(), nexttowardf() и nexttowardl() делают то же, что и функции nextafter(), за исключением того, что у них второй аргумент имеет тип long double.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶
При успешном выполнении данные функции возвращают представимое значение с плавающей запятой следующее за x по направлению к y.
Если x = y, то возвращается значение y (приведённое к типу x).
Если значение x или y равно NaN, будет возвращено NaN.
Если x имеет конечное значение и происходит переполнение результата, возникает ошибка диапазона, то функции возвращают HUGE_VAL, HUGE_VALF или HUGE_VALL, соответственно, с математически правильным знаком.
Если x не равно y, и правильный результат функции был бы субнормальным, нулём или возникала бы исчерпание степени, ошибка диапазона, то возвращается любое правильное значение (если оно представимо) или 0,0.
ОШИБКИ¶
Смотрите math_error(7), чтобы определить, какие ошибки могут возникать при вызове этих функций.
Могут возникать следующие ошибки:
- Ошибка диапазона: результат превысил разрядность
- Значение errno устанавливается в ERANGE. Возникает исключение переполнения плавающей запятой (FE_OVERFLOW).
- Ошибка диапазона: результат субнормальный или исчерпание степени
- Значение errno устанавливается в ERANGE. Возникает исключение исчерпания степени чисел с плавающей запятой (FE_UNDERFLOW).
АТРИБУТЫ¶
Описание терминов данного раздела смотрите в attributes(7).
Интерфейс | Атрибут | Значение |
nextafter(), nextafterf(), nextafterl(), nexttoward(), nexttowardf(), nexttowardl() | Безвредность в нитях | MT-Safe |
СООТВЕТСТВИЕ СТАНДАРТАМ¶
C99, POSIX.1-2001, POSIX.1-2008. Эта функция определена в IEC 559 (и в приложении с рекомендуемыми функциями IEEE 754/IEEE 854).
ДЕФЕКТЫ¶
В glibc 2.5 и младше данные функции не вызывают исключение исчерпания степени плавающей запятой (FE_UNDERFLOW) при возникновении ошибки исчерпания степени.
Before glibc version 2.23 these functions did not set errno.
СМ. ТАКЖЕ¶
ЗАМЕЧАНИЯ¶
Эта страница является частью проекта Linux man-pages версии 5.10. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.
ПЕРЕВОД¶
Русский перевод этой страницы руководства был сделан Alex Nik <rage.iz.me@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Dmitry Bolkhovskikh <d20052005@yandex.ru>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>
Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.
Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.
21 декабря 2020 г. | GNU |