rsqrt(3M)

構文

#include <math.h>

double rsqrt(double x);

float rsqrtf(float x);

long double rsqrtl(long double x);

extended rsqrtw(extended x);

quad rsqrtq(quad x);

説明

これらの関数は、Itanium ベース システムでのみ使用できます。

rsqrt() は、 x の負でない平方根の逆数を返します。

式 a*rsqrt(b) は、 a/sqrt(b) より高性能な代替として用意されています。 この ２ つの式は、精度は同程度ですが、すべての場合にまったく同じ計算結果になるわけではありません。 たとえば、 a*rsqrt(a*a + b*b) では、まれにほんの少しだけ １ を超えることがあります。

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

使用方法

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

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

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

戻り値

x が ±0 の場合、 rsqrt() は ±INFINITY を返し、ゼロ除算例外が発生します。

x が +INFINITY の場合、 rsqrt() は +0 を返します。

x が NaN の場合、 rsqrt() は NaN を返します。

x がゼロより小さい場合、 rsqrt() は NaN を返し、無効浮動小数点例外が発生します。

rsqrt() では、丸めた結果が数学上の結果と等しくないときには必ず、不正確例外が発生します。

エラー

エラーは、定義されていません。

参照

sqrt(3M), math(5)

標準準拠

これらの関数は、どの標準にも規定されていません。