Developer Reference

Contents

v?Powx

Computes vector
a
to the scalar power
b
.

Syntax

vsPowx
(
n
,
a
,
b
,
y
)
;
vsPowxI(n, a, inca, b, y, incy);
vmsPowx
(
n
,
a
,
b
,
y
,
mode
)
;
vmsPowxI(n, a, inca, b, y, incy, mode);
vdPowx
(
n
,
a
,
b
,
y
)
;
vdPowxI(n, a, inca, b, y, incy);
vmdPowx
(
n
,
a
,
b
,
y
,
mode
)
;
vmdPowxI(n, a, inca, b, y, incy, mode);
vcPowx
(
n
,
a
,
b
,
y
)
;
vcPowxI(n, a, inca, b, y, incy);
vmcPowx
(
n
,
a
,
b
,
y
,
mode
)
;
vmcPowxI(n, a, inca, b, y, incy, mode);
vzPowx
(
n
,
a
,
b
,
y
)
;
vzPowxI(n, a, inca, b, y, incy);
vmzPowx
(
n
,
a
,
b
,
y
,
mode
)
;
vmzPowxI(n, a, inca, b, y, incy, mode);
Include Files
  • mkl.h
Input Parameters
Name
Type
Description
n
const MKL_INT
Number of elements to be calculated.
a
const float*
for
vsPowx
,
vmsPowx
const double*
for
vdPowx
,
vmdPowx
const MKL_Complex8*
for
vcPowx
,
vmcPowx
const MKL_Complex16*
for
vzPowx
,
vmzPowx
Pointer to an array that contains the input vector
a
.
b
const float
for
vsPowx
,
vmsPowx
const double
for
vdPowx
,
vmdPowx
const MKL_Complex8
for
vcPowx
,
vmcPowx
const MKL_Complex16
for
vzPowx
,
vmzPowx
Constant value for power
b
.
inca
,
incy
const MKL_INT
Specifies increments for the elements of
a
and
y
.
mode
const MKL_INT64
Overrides global VM mode setting for this function call. See
vmlSetMode
for possible values and their description.
Precision Overflow Thresholds for Real
v?Powx
Function
Data Type
Threshold Limitations on Input Parameters
single precision
abs(
a
[i]) < ( FLT_MAX )
1/b
double precision
abs(
a
[i]) < ( DBL_MAX )
1/b
Precision overflow thresholds for the complex
v?Powx
function are beyond the scope of this document.
Output Parameters
Name
Type
Description
y
float*
for
vsPowx
,
vmsPowx
double*
for
vdPowx
,
vmdPowx
MKL_Complex8*
for
vcPowx
,
vmcPowx
MKL_Complex16*
for
vzPowx
,
vmzPowx
Pointer to an array that contains the output vector
y
.
Description
The
v?Powx
function computes
a
to the power
b
for a vector
a
and a scalar
b
.
The real function
v(s/d)Powx
has certain limitations on the input range of
a
and
b
parameters. Specifically, if
a
[i]
is positive, then
b
may be arbitrary. For negative
a
[i]
, the value of
b
must be an integer (either positive or negative).
The complex function
v(c/z)Powx
has no input range limitations.
Special values and VM Error Status treatment are the same as for the
v?Pow
function.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.