pow
power function
INTERFACE
#include <math.h>
double pow ( double x, double y )
long powl ( long double x, long double y )
float powf ( float x, float y )
#include <complex.h>
double complex cpow(double complex x, complex double y)
float complex cpowf(float complex x, complex float y)
long double complex cpowl(long double complex x, complex long double y)
DESCRIPTION
The pow functions compute x raised to the power of y, i.e.
SPECIAL VALUES
pow ( ±0, y ) returns ±∞ and raises the divide-by-zero floating-point exception for y an odd integer.
pow ( ±0, y ) returns +∞ and raises the divide-by-zero floating-point exception for y < 0 and not an odd integer.
pow ( ±0, y ) returns ±0 for y an odd integer > 0.
pow ( ±0, y ) returns +0 for y > 0 and not an odd integer.
pow ( -1, ±∞ ) returns 1.
pow ( 1, y ) returns 1 for any y, even a NaN.
pow ( x, ±0 ) returns 1 for any x, even a NaN.
pow ( x, y ) returns a NaN and raises the invalid floating-point exception for finite x < 0 and finite non-integer y.
pow ( x, -∞ ) returns +∞ for |x| < 1.
pow ( x, -∞ ) returns +0 for |x| > 1.
pow ( x, +∞ ) returns +0 for |x| < 1.
pow ( x, +∞ ) returns +∞ for |x| > 1.
pow ( -∞, y ) returns -0 for y an odd integer < 0.
pow ( -∞, y ) returns +0 for y < 0 and not an odd integer.
pow ( -∞, y ) returns -∞ for y an odd integer > 0.
pow ( -∞, y ) returns +∞ for y > 0 and not an odd integer.
pow ( +∞, y ) returns +0 for y < 0.
pow ( +∞, y ) returns +∞ 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.
SEE ALSO
STANDARDS
The pow function conforms to ISO/IEC 9899:1999(E).