pow, powf, powl

パラメータ

戻り値

エラーが発生しない場合、 base の exponent 乗（ base exponent
）が返されます。

定義域エラーが発生した場合、実装定義の値が返されます（NaNがサポートされている場合はNaN）。

極エラーまたはオーバーフローによる範囲エラーが発生した場合、 ± HUGE_VAL 、 ±HUGE_VALF または ±HUGE_VALL が返されます。

アンダーフローによる範囲エラーが発生した場合、正しい結果（丸め後）が返されます。

エラー処理

エラーは math_errhandling で指定された通りに報告されます。

base が有限かつ負の値であり、かつ exponent が有限かつ非整数の場合、定義域エラーが発生し、値域エラーが発生する可能性があります。

base がゼロかつ exponent がゼロの場合、定義域エラーが発生する可能性があります。

base がゼロで、 exponent が負の場合、定義域エラーまたは極エラーが発生する可能性があります。

IEEE浮動小数点演算（IEC 60559）を実装がサポートしている場合、

• pow ( + 0 , exponent ) 、ただし exponent が負の奇数の場合、 +∞ を返し、 FE_DIVBYZERO を発生させる
• pow ( - 0 , exponent ) 、ここで exponent が負の奇数の場合、 -∞ を返し、 FE_DIVBYZERO を発生させる
• pow ( ± 0 , exponent ) 、ただし exponent が負の有限値で、かつ偶数整数または非整数の場合、+∞を返し FE_DIVBYZERO を発生させる
• pow ( ± 0 , - ∞ ) +∞を返す および FE_DIVBYZERO を発生させる可能性がある (C23まで)
• pow ( + 0 , exponent ) 、ただし exponent が正の奇数の整数の場合、+0を返す
• pow ( - 0 , exponent ) 、ここで exponent が正の奇数の場合、-0を返します
• pow ( ± 0 , exponent ) 、ただし exponent が正の非整数または正の偶数の整数の場合、+0を返す
• pow ( - 1 , ±∞ ) は 1 を返します
• pow ( + 1 , exponent ) は任意の exponent に対して 1 を返します。 exponent が NaN の場合でも同様です。
• pow ( base, ± 0 ) は、あらゆる base に対して 1 を返します。 base が NaN の場合でも同様です。
• pow ( base, exponent ) は NaN を返し、 FE_INVALID を発生させる。ただし、 base が有限値かつ負の値であり、かつ exponent が有限値かつ非整数の場合に限る。
• pow ( base, - ∞ ) は、任意の |base|<1 に対して +∞ を返します
• pow ( base, - ∞ ) は、任意の |base|>1 に対して +0 を返します
• pow ( base, + ∞ ) は任意の |base|<1 に対して+0を返す
• pow ( base, + ∞ ) は任意の |base|>1 に対して+∞を返します
• pow ( - ∞, exponent ) exponentが負の奇数の場合、-0を返す
• pow ( - ∞, exponent ) exponent が負の非整数または負の偶数の場合、+0を返す
• pow ( - ∞, exponent ) exponentが正の奇数の場合、-∞を返す
• pow ( - ∞, exponent ) は、 exponent が正の非整数または正の偶数の整数である場合に+∞を返します
• pow ( + ∞, exponent ) は、任意の負の exponent に対して +0 を返します
• pow ( + ∞, exponent ) は任意の正の exponent に対して +∞ を返します
• 上記で指定されている場合を除き、いずれかの引数がNaNの場合、NaNが返されます。

注記

負の数の根を得るために pow を使用することはできませんが、 cbrt は exponent が 1 / 3 という一般的なケースに対して提供されています。

例

#include <errno.h>
#include <fenv.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    // 典型的な使用例
    printf("pow(2, 10) = %f\n", pow(2, 10));
    printf("pow(2, 0.5) = %f\n", pow(2, 0.5));
    printf("pow(-2, -3) = %f\n", pow(-2, -3));
    // 特殊な値
    printf("pow(-1, NAN) = %f\n", pow(-1, NAN));
    printf("pow(+1, NAN) = %f\n", pow(+1, NAN));
    printf("pow(INFINITY, 2) = %f\n", pow(INFINITY, 2));
    printf("pow(INFINITY, -1) = %f\n", pow(INFINITY, -1));
    // エラー処理
    errno = 0; feclearexcept(FE_ALL_EXCEPT);
    printf("pow(-1, 1/3) = %f\n", pow(-1, 1.0 / 3));
    if (errno == EDOM)
        perror("    errno == EDOM");
    if (fetestexcept(FE_INVALID))
        puts("    FE_INVALID raised");
    feclearexcept(FE_ALL_EXCEPT);
    printf("pow(-0, -3) = %f\n", pow(-0.0, -3));
    if (fetestexcept(FE_DIVBYZERO))
        puts("    FE_DIVBYZERO raised");
}

pow(2, 10) = 1024.000000
pow(2, 0.5) = 1.414214
pow(-2, -3) = -0.125000
pow(-1, NAN) = nan
pow(+1, NAN) = 1.000000
pow(INFINITY, 2) = inf
pow(INFINITY, -1) = 0.000000
pow(-1, 1/3) = -nan
    errno == EDOM: Numerical argument out of domain
    FE_INVALID raised
pow(-0, -3) = -inf
    FE_DIVBYZERO raised

参考文献

関連項目