nextafter、 nextafterf、 nextafterl、 _nextafter、 _nextafterf、 nexttoward、 nexttowardf、 nexttowardl
次の表現可能な浮動小数点値を返します。
構文
double nextafter( double x, double y );
float nextafterf( float x, float y );
long double nextafterl( long double x, long double y );
double _nextafter( double x, double y );
float _nextafterf( float x, float y ); /* x64 only */
#define nextafter(X, Y) // Requires C11 or higher
double nexttoward( double x, long double y );
float nexttowardf( float x, long double y );
long double nexttowardl( long double x, long double y );
#define nexttoward(X, Y) // Requires C11 or higher
float nextafter( float x, float y ); /* C++ only, requires <cmath> */
long double nextafter( long double x, long double y ); /* C++ only, requires <cmath> */
float nexttoward( float x, long double y ); /* C++ only, requires <cmath> */
long double nexttoward( long double x, long double y ); /* C++ only, requires <cmath> */
パラメーター
x
開始する浮動小数点値。
y
移動する浮動小数点値。
戻り値
x の後の戻り値の型の、次の表現可能な浮動小数点値を y の方向に返します。 x と y が等しい場合、この関数は、戻り値の型に変換された y を、例外をトリガーすることなく返します。 xがyと等しく、結果が非正規化またはゼロの場合、FE_UNDERFLOWとFE_INEXACT浮動小数点例外の状態が設定され、正しい結果が返されます。 x または y が NAN の場合、戻り値は入力 NAN のいずれかとなります。 x が有限であり、結果が無限、または型で表現できない場合、正しく署名された無限大または NAN が返され、FE_OVERFLOW と FE_INEXACT の浮動小数点例外の状態が設定され、errno が ERANGE に設定されます。
解説
nextafter と nexttoward の関数ファミリは、y のパラメーターの型を除いて同等です。 x と y が等しい場合、戻り値は戻り値の型に変換された y になります。
C++ ではオーバーロードが可能であるため、<cmath> を含めると、float と long double 型を返す nextafter と nexttoward のオーバーロードを呼び出すことができます。 C プログラムでは、この関数を呼び出すために <tgmath.h> マクロが使用されていない限り、nextafter と nexttoward は常に double を返します。
<tgmath.h>からnextafterまたはnexttowardマクロを使用する場合、引数の型によって、選択される関数のバージョンが決まります。 詳細については、「ジェネリック型数値演算」を参照してください。
_nextafter と _nextafterf は、Microsoft 固有の関数です。 _nextafterf 関数は、x64 用にコンパイルするときにのみ使用できます。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。
要件
| ルーチンによって返される値 | 必須ヘッダー (C) | 必須ヘッダー (C++) |
|---|---|---|
nextafter、 nextafterf、 nextafterl、 _nextafterf、 nexttoward、 nexttowardf、 nexttowardl |
<math.h> |
<math.h> または <cmath> |
_nextafter |
<float.h> |
<float.h> または <cfloat> |
nextafter マクロ、nexttoward マクロ |
<tgmath.h> |
互換性の詳細については、「 Compatibility」を参照してください。