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 でのグローバル状態」を参照してください。

要件

互換性の詳細については、「 Compatibility」を参照してください。

関連項目

数値演算と浮動小数点のサポート
isnan、 _isnan、 _isnanf