ИМЯ¶

nextafter, nextafterf, nextafterl, nexttoward, nexttowardf, nexttowardl - операции над числами с плавающей запятой

LIBRARY¶

Math library (libm, -lm)

СИНТАКСИС¶

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

nextafter():

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L


        || _XOPEN_SOURCE >= 500


        || /* начиная с glibc 2.19: */ _DEFAULT_SOURCE


        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

nextafterf(), nextafterl():

    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L


        || /* начиная с glibc 2.19: */ _DEFAULT_SOURCE


        || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE

nexttoward(), nexttowardf(), nexttowardl():

    _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE


        || _POSIX_C_SOURCE >= 200112L

ОПИСАНИЕ¶

Функции 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).

СТАНДАРТЫ¶

C11, POSIX.1-2008.

This function is defined in IEC 559 (and the appendix with recommended functions in IEEE 754/IEEE 854).

ИСТОРИЯ¶

C99, POSIX.1-2001.

ОШИБКИ¶

In glibc 2.5 and earlier, these functions do not raise an underflow floating-point (FE_UNDERFLOW) exception when an underflow occurs.

Before glibc 2.23 these functions did not set errno.

СМОТРИТЕ ТАКЖЕ¶

nearbyint(3)

ПЕРЕВОД¶

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

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