pow(3M)

Itanium(R) ベース システムのみ

long double powl(long double x, long double y);

extended poww(extended x, extended y);

quad powq(quad x, quad y);

double pown(double x, int y);

float pownf(float x, int y);

long double pownl(long double x, int y);

extended pownw(extended x, int y);

quad pownq(quad x, int y);

double powlln(double x, long long y);

float powllnf(float x, long long y);

long double powllnl(long double x, long long y);

extended powllnw(extended x, long long y);

quad powllnq(quad x, long long y);

Itanium ベース システムのみ

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

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

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

pown() 関数は、 x^y を返します。

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

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

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

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

powlln() 関数は x^y を返します。

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

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

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

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

PA-RISC のみ

pow() 関数のミリコードバージョンが提供されています。 数学ライブラリ関数のミリコードバージョンは通常、 標準ライブラリのものより処理が高速です。 これらのバージョンを使用するには、 +Olibcalls または +Oaggressive 最適化オプションを指定して、プログラムをコンパイルしてください。

特殊な場合に、 ミリコードバージョンはその標準ライブラリと同じ値を返しますが、 errno を設定しません (「戻り値」の項を参照)。

Itanium ベース システム

Itanium ベース システムの場合、 pow() 関数は以下の特殊な場合に、C99 仕様に従います。

pow(±0,y) は、０ より小さい奇数の整数 y に対して、 ±Inf を返し、 ゼロ除算浮動小数点例外が発生します。

pow(±0,y) は、０ より小さい奇数の整数以外の y に対して、+Inf を返し、 ゼロ除算浮動小数点例外が発生します。

pow(±0,y) は、０ より大きい奇数の整数 y に対して ±0 を返します。

pow(±0,y) は、０ より大きい奇数の整数以外の y に対して +0 を返します。

pow(-1,±Inf) は １ を返します。

pow(+1,x) は、NaN を含むすべての x に対して １ を返します。

pow(x,±0) は、NaN を含むすべての x に対して １ を返します。

pow(x,y) は、０ より小さい有限値 x および整数でない有限値 y に対して、NaN を返し、 無効浮動小数点例外が発生します。

pow(x,-Inf) は、 |x|<1 に対して +Inf を返します。

pow(x,-Inf) は、 |x|>1 に対して +0 を返します。

pow(x,+Inf) は、 |x|<1 に対して +0 を返します。

pow(x,+Inf) は、 |x|>1 に対して +Inf を返します。

pow(-Inf,y) は、０ より小さい奇数の整数 y に対して -0 を返します。

pow(-Inf,y) は、０ より小さい奇数の整数以外の y に対して +0 を返します。

pow(-Inf,y) は、０ より大きい奇数の整数 y に対して -Inf を返します。

pow(-Inf,y) は、０ より大きい奇数の整数以外の y に対して +Inf を返します。

pow(+Inf,y) は、０ より小さい y に対して +0 を返します。

pow(+Inf,y) は、０ より大きい y に対して +inf を返します。

上記以外で、どちらかの引き数が NaN の場合、 pow() は NaN を返します。

pow() は、値が大きすぎる場合これに代えて無限大を返し、オーバーフロー例外と不正確例外を発生させます。

pow() では、結果が非常に小さく (本質的にはデノーマル値やゼロ) 正確な値でなくなるときには必ず、アンダーフロー例外と不正確例外が発生します。 また、結果が非常に小さいというだけで、これらの例外が発生することがあります。

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

下記の PA-RISC の動作に相当する、 pow() の戻り値と errno の設定値は、 Itanium ベース システムの場合、 +Olibmerrno オプションを指定してコンパイルすることによって得ることができます。

pown() および powlln() 関数は、適用可能な特殊なケースやエラーが発生した場合には pow() 関数の仕様に従います。

PA-RISC

x と y が両方とも ０ の場合、 pow() は 1.0 を返します。

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

x がゼロで、 y が負の有限値の場合、 pow() は -HUGE_VAL (-INFINITY に等しい) を返します。

x が有限値でゼロより小さく、 y が有限値で整数でない場合、 pow() は NaN を返します。

正しい値がオーバーフローする場合、 pow() は ±HUGE_VAL (+/-INFINITY に等しい) を返します。