Math Vector Library
Programming Reference Manual C/C++
Version 1.1 DD-00002-011

17.4 vcpows - Vector complex power scalar exponent xy

#include <mvec.h> 
 
void vcpows (int n, double complex *restrict z, int incz, const double complex *restrict x, 
             int incx, double complex y); 
void vcpowsf(int n, float complex *restrict z, int incz, const float complex *restrict x, 
             int incx, float complex y); 
 
void vcpows_64 (long n, double complex *restrict z, long incz, const double complex *restrict x, 
                long incx, double complex y); 
void vcpowsf_64(long n, float complex *restrict z, long incz, const float complex *restrict x, 
                long incx, float complex y);

Given an input vectors x  and a scalar value y as well as a result vector z  , this function computes:

z= xy

17.4.1 Parameters

N - INTEGER

ENTRY: Number of elements of x  and y  .
CONSTRAINT: n ≥1  .

z - ARRAY OF COMPLEX

EXIT: Result vector z  .
CONSTRAINT: Must contain n× incz  elements.
CONSTRAINT: Must not overlap with array x  .

INCZ - INTEGER

ENTRY: Stride for the vector z  .
CONSTRAINT: incz̸= 0  .
BEHAVIOR: A negative stride will traverse the array in reverse.

X - ARRAY OF COMPLEX

ENTRY: Input vector x  .
CONSTRAINT: Must contain n× incx  elements.
CONSTRAINT: Must not overlap with array z  .

INCX - INTEGER

ENTRY: Stride for the vector x  .
CONSTRAINT: incx̸= 0  .
BEHAVIOR: A negative stride will traverse the array in reverse.

Y - COMPLEX

ENTRY: Exponentiation value y .