powd64(3M)																powd64(3M)

NAME

       powd64(), powd128(), powd32() - decimal power functions

SYNOPSIS

DESCRIPTION

       The function returns

       is a version of it takes arguments and returns a result.

       is a version of it takes arguments and returns a result.

       These math functions are supported for HP-UX 11i Version 3 September 2008 Update and forward.

USAGE

       To use any of these functions, compile with the option.

       Make sure your program defines and then includes

       Link in the math library by specifying or on the linking command line.

       For more information, see the at the following site:

RETURN VALUE

       and raises the divide-by-zero floating-point exception for y an odd integer < 0.

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

       for y an odd integer > 0.

       returns +0 for y>0 and not an odd integer.

       returns 1.

       returns 1 for any x, even NaN.

       returns 1 for any x, even NaN.

       returns NaN and raises the invalid floating-point exception for finite x<0 and finite non-integer y.

       returns +infinity for |x|<1.

       returns +0 for |x|>1.

       returns +0 for |x|<1.

       returns +infinity for |x|>1.

       returns -0 for y an odd integer < 0.

       returns +0 for y<0 and not an odd integer.

       returns -infinity for y an odd integer > 0.

       returns +infinity for y>0 and not an odd integer.

       returns +0 for y<0.

       returns +inf for y>0.

       Otherwise, if either argument is NaN, then returns NaN.

       returns	the  properly signed infinity (or, in some non-default rounding direction modes, the properly signed maximum-magnitude finite num-
       ber) in lieu of a value whose magnitude is too large, and raises the overflow and inexact exceptions.

       raises the underflow exception whenever a result is tiny (essentially subnormal or zero) and inexact.

       raises the inexact exception whenever a rounded result does not equal the mathematical result.

ERRORS

       For finite x<0 and finite non-integer y, sets to

       sets to if y is an odd integer < 0.

       sets to if y<0 and not an odd integer.

       If the correct value would overflow, sets to

SEE ALSO

       cbrtd64(3M), expd64(3M), logd64(3M), scalblnd64(3M), scalbnd64(3M), sqrtd64(3M), math(5).

STANDARDS CONFORMANCE

       These functions conform to ISO/IEC TR 24732, "Extension for the programming language C to support decimal floating-point arithmetic".

							     HP Integrity Server Only							powd64(3M)