nextafter(3)

1NEXTAFTER(3)               Linux Programmer's Manual              NEXTAFTER(3)
2
3
4

NAME

6       nextafter, nextafterf, nextafterl, nexttoward, nexttowardf, nexttowardl
7       - floating-point number manipulation
8

SYNOPSIS

10       #include <math.h>
11
12       double nextafter(double x, double y);
13       float nextafterf(float x, float y);
14       long double nextafterl(long double x, long double y);
15
16       double nexttoward(double x, long double y);
17       float nexttowardf(float x, long double y);
18       long double nexttowardl(long double x, long double y);
19
20       Link with -lm.
21
22   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
23
24       nextafter():
25           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
26               || _XOPEN_SOURCE >= 500
27               || /* Since glibc 2.19: */ _DEFAULT_SOURCE
28               || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
29       nextafterf(), nextafterl():
30           _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
31               || /* Since glibc 2.19: */ _DEFAULT_SOURCE
32               || /* Glibc versions <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
33       nexttoward(), nexttowardf(), nexttowardl():
34           _XOPEN_SOURCE >= 600 || _ISOC99_SOURCE ||
35           _POSIX_C_SOURCE >= 200112L
36

DESCRIPTION

38       The  nextafter(),  nextafterf(),  and nextafterl() functions return the
39       next representable floating-point value following x in the direction of
40       y.  If y is less than x, these functions will return the largest repre‐
41       sentable number less than x.
42
43       If x equals y, the functions return y.
44
45       The nexttoward(), nexttowardf(), and  nexttowardl()  functions  do  the
46       same  as the corresponding nextafter() functions, except that they have
47       a long double second argument.
48

RETURN VALUE

50       On success, these functions return  the  next  representable  floating-
51       point value after x in the direction of y.
52
53       If x equals y, then y (cast to the same type as x) is returned.
54
55       If x or y is a NaN, a NaN is returned.
56
57       If  x  is  finite, and the result would overflow, a range error occurs,
58       and the functions return HUGE_VAL,  HUGE_VALF,  or  HUGE_VALL,  respec‐
59       tively, with the correct mathematical sign.
60
61       If  x  is not equal to y, and the correct function result would be sub‐
62       normal, zero, or underflow, a range error occurs, and either  the  cor‐
63       rect value (if it can be represented), or 0.0, is returned.
64

ERRORS

66       See  math_error(7) for information on how to determine whether an error
67       has occurred when calling these functions.
68
69       The following errors can occur:
70
71       Range error: result overflow
72              errno is set to ERANGE.  An  overflow  floating-point  exception
73              (FE_OVERFLOW) is raised.
74
75       Range error: result is subnormal or underflows
76              errno  is  set to ERANGE.  An underflow floating-point exception
77              (FE_UNDERFLOW) is raised.
78

ATTRIBUTES

80       For  an  explanation  of  the  terms  used   in   this   section,   see
81       attributes(7).
82
83       ┌─────────────────────────────┬───────────────┬─────────┐
84       │Interface                    │ Attribute     │ Value   │
85       ├─────────────────────────────┼───────────────┼─────────┤
86       │nextafter(), nextafterf(),   │ Thread safety │ MT-Safe │
87       │nextafterl(), nexttoward(),  │               │         │
88       │nexttowardf(), nexttowardl() │               │         │
89       └─────────────────────────────┴───────────────┴─────────┘

CONFORMING TO

91       C99,  POSIX.1-2001,  POSIX.1-2008.  This function is defined in IEC 559
92       (and the appendix with recommended functions in IEEE 754/IEEE 854).
93

BUGS

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

BUGS

100       Before glibc version 2.23 these functions did not set errno.
101

COLOPHON

106       This page is part of release 5.07 of the Linux  man-pages  project.   A
107       description  of  the project, information about reporting bugs, and the
108       latest    version    of    this    page,    can     be     found     at
109       https://www.kernel.org/doc/man-pages/.
110
111
112
113GNU                               2020-06-09                      NEXTAFTER(3)