nextafter(3M)

構文

#include <math.h>

double nextafter(double x, double y);

float nextafterf(float x, float y);

説明

関数 nextafter() は、 y の方向で x の次に表現可能な倍精度値を計算します。 したがって、 y が x より小さい場合、 nextafter() は、 x より小さい表現可能な浮動小数点数のうち最大のものを返します。

x が y に等しい場合、 nextafter() 関数は、 y を返します。

関数 nexttoward() は、２ 番目の引き数の型が long double であることと、 x が y に等しい場合、 y をこの関数の型に変換して返すことを除いて、 nextafter() と同等です。

関数 nexttoward() の結果は、関数の型によって決まります。 ２ 番目の浮動引き数の型は、関数の型に比べて範囲が広いこともあり、２ 番目の引き数の中で範囲や精度は損なわれません。

nextafterf() は、 nextafter() の float バージョンで、 float 型の引き数をとり、 float 型の結果を返します。

nextafterl() は、 nextafter() の long double バージョンで、 long double 型の引き数をとり、 long double 型の結果を返します。

nextafterw() は、 nextafter() の extended バージョンで、 extended 型の引き数をとり、 extended 型の結果を返します。

nextafterq() は、HP-UX システムでは nextafterl() と同等です。

nexttowardf() は、 nexttoward() の float バージョンで、 float 型の (第 １) 引き数をとり、 float 型の結果を返します。

nexttowardl() は nextafterl() と同等です。

nexttowardw() は、 nexttoward() の extended バージョンで、 extended 型の (第 １) 引き数をとり、 extended 型の結果を返します。

nexttowardq() は、HP-UX システムでは nexttowardl() と同等です。

使用方法

これらの関数を使用するには、デフォルトの -Ae オプションを指定するか、または -Aa オプションと -D_HPUX_SOURCE オプションを指定してコンパイルしてください。

Itanium ベース システムで nextafterw()、 nextafterq()、 nexttowardw()、 または nexttowardq() を使うには、 -fpwidetypes オプションも指定してコンパイルしてください。

プログラムに <math.h> がインクルードされていることを確認した後、 コンパイラまたはリンカーのコマンド行で -lm を指定して、数学ライブラリとリンクしてください。

戻り値

x が y に等しい場合、 nextafter() は y 返して、 nexttoward() は、 x の型に変換された y を返します。

x または y が NaN の場合、 nextafter() および nexttoward() は NaN を返します。

x が有限で、正しい関数値がオーバーフローする場合、 nextafter() および nexttoward() は、 x の符号に応じて ±HUGE_VAL (+INFINITY に等しい) を返し、オーバーフロー例外が発生します。

戻り値がデノーマル値で、 x!=y の場合、 これらの関数で、アンダーフロー浮動小数点例外と不正確浮動小数点例外が発生します。

エラー

x が有限で、正しい関数値がオーバーフローする場合、 nextafter() は errno に [ERANGE] を設定します。

参照

scalbn(3M), math(5)

標準準拠

nextafter() : SVID3, XPG4.2, ISO/IEC C99 (付録 F 『IEC 60559 floating-point arithmetic』を含む)

nextafterf(), nextafterl(), nexttoward(), nexttowardf(), nexttowardl() : ISO/IEC C99 (付録 F 『IEC 60559 floating-point arithmetic』を含む)