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

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804