cpow.3m (2010 09)

cpow(3M) cpow(3M)

(HP Integrity Server Only)

NAME

cpow( ), cpowf( ), cpowl( ), cpoww( ), cpowq( ) - complex power functions

SYNOPSIS

#include <complex.h>

double complex cpow(double complex x, double complex y);

float complex cpowf(float complex x, float complex y);

long double complex cpowl(long double complex x, long double complex y);

extended complex cpoww(extended complex x, extended complex y);

quad complex cpowq(quad complex x, quad complex y);

DESCRIPTION

These functions are available only for Integrity servers.

cpow() returns x

. There is a branch cut for the ﬁrst parameter along the negative real axis.

cpowf() is a float complex version of

cpow(); it takes float complex arguments and returns a

float complex result.

cpowl() is a long double complex version of cpow(); it takes long double complex argu-

ments and returns a long double complex result.

cpoww() is an extended complex version of cpow(); it takes a extended complex arguments

and returns an extended complex result.

cpowq() is equivalent to cpowl() on HP-UX systems.

USAGE

To use these functions, compile with the default

-Ae option. To use cpoww() or

cpowq(), compile

with the

-fpwidetypes option. Make sure your program includes <complex.h>. Link in the math

library by specifying -lm on the compiler or linker command line.

RETURN VALUE

cpow(x ,y) returns the value calculated by cexp(y *clog(x )) and raises the exceptions from that cal-

culation, for non-zero y . (The intermediate calculations may be done to greater precision and range.)

cpow(x,±0±i0) returns 1+i0.

ERRORS

No errors are deﬁned.