[Contents] [Previous Section] [Next Section] [Index]


pow-Raise the Base to a Floating-Point Exponent

Interface

F_TYPE pow (F_TYPE x, F_TYPE y)

Description

pow() raises a floating-point base x to a floating-point exponent y. The value of pow(x,y) is computed as e**(y ln(x)) for positive x. If x is 0 or negative, see your language reference manual.

Passing a NaN input value to pow() produces a NaN result, for y not equal to 0. For pow(NaN,0), see your language reference manual.

Exceptions


Exceptional Argument       Routine Behavior

y ln(x) > ln(max_float)    Overflow

y ln(x) < ln(min_float)    Underflow

Fortran-Exceptional Argument Routine Behavior x < 0 Invalid argument x = 0 and y < 0 Invalid argument x = 0 and y = 0 Invalid argument x = +infinity and y = 0 Invalid argument x = 1 and |y| = infinity Invalid argument
ANSI C-Exceptional Argument Routine Behavior |x| = 1 and |y| = Invalid argument infinity x < 0 and y is not Invalid argument integral

See Also

Appendix A, Critical Floating-Point Values


[Contents] [Previous Section] [Next Section] [Index]