POW(3) BSD Library Functions Manual POW(3)

NAME
     ppooww - power function

SYNOPSIS
     ##iinncclluuddee <>

     double
     ppooww(double x, double y);

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

     float
     ppoowwff(float x, float y);

DESCRIPTION
     The ppooww() functions compute x raised to the power y.

SSPPEECCIIAALL VVAALLUUEESS
     ppooww(+-0, y) returns +-infinity and raises the "divide-by-zero" floating-
     point exception for y an odd integer < 0.

     ppooww(+-0, y) returns +infinity and raises the "divide-by-zero" floating-
     point exception for y < 0 and not an odd integer.

     ppooww(+-0, y) returns +-0 for y an odd integer > 0.

     ppooww(+-0, y) returns +0 for y > 0 and not an odd integer.

     ppooww(-1, +-infinity) returns 1.

     ppooww(1, y) returns 1 for any y, even a NaN.

     ppooww(x, +-0) returns 1 for any x, even a NaN.

     ppooww(x, y) returns a NaN and raises the "invalid" floating-point exception
     for finite x < 0 and finite non-integer y.

     ppooww(x, -infinity) returns +infinity for |x| < 1.

     ppooww(x, -infinity) returns +0 for |x| > 1.

     ppooww(x, +infinity) returns +0 for |x| < 1.

     ppooww(x, +infinity) returns +infinity for |x| > 1.

     ppooww(-infinity, y) returns -0 for y an odd integer < 0.

     ppooww(-infinity, y) returns +0 for y < 0 and not an odd integer.

     ppooww(-infinity, y) returns -infinity for y an odd integer > 0.

     ppooww(-infinity, y) returns +infinity for y > 0 and not an odd integer.

     ppooww(+infinity, y) returns +0 for y < 0.

     ppooww(+infinity, y) returns +infinity for y > 0.

     A domain error occurs if x is finite and negative and y is finite and not
     an integer.

     A domain error can occur if x is 0 and y less than or equal to 0.

     Range errors may occur.

SEE ALSO
     math(3)

STANDARDS     The ppooww() function conforms to ISO/IEC 9899:1999(E).

4th Berkeley Distribution        July 12, 2003       4th Berkeley Distribution