НАИМЕНОВАНИЕ

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

БИБЛИОТЕКА

       Математическая библиотека (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);

   Требования макроса тестирования свойств для glibc (см. feature_test_macros(7)):

       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).
       ┌─────────────────────────────────────────────────────────────────────┬──────────────────────┬──────────┐
       │ Интерфейс                                                           │ Атрибут              │ Значение │
       ├─────────────────────────────────────────────────────────────────────┼──────────────────────┼──────────┤
       │ nextafter(), nextafterf(), nextafterl(), nexttoward(),              │ Безвредность в нитях │ MT-Safe  │
       │ nexttowardf(), nexttowardl()                                        │                      │          │
       └─────────────────────────────────────────────────────────────────────┴──────────────────────┴──────────┘

СТАНДАРТЫ

       C11, POSIX.1-2008.

       Эта функция определена в IEC 559 (и в приложении с рекомендуемыми функциями 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> и Kirill Rekhov <krekhov.dev@gmail.com>

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

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

Справочные страницы Linux 6.9.1                   2 мая 2024 г.                                     nextafter(3)