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

21.3 vcsub - Vector complex subtraction x-y

#include <mvec.h> 
 
void vcsub (int n, double complex *restrict z, int incz, const double complex *restrict x, 
            int incx, const double complex *restrict y, int incy); 
void vcsubf(int n, float complex *restrict z, int incz, const float complex *restrict x, 
            int incx, const float complex *restrict y, int incy); 
 
void vcsub_64 (long n, double complex *restrict z, long incz, const double complex *restrict x, 
               long incx, const double complex *restrict y, long incy); 
void vcsubf_64(long n, float complex *restrict z, long incz, const float complex *restrict x, 
               long incx,  const float complex *restrict y, long incy);

Given input vectors x  and y  and a result vector z  , this function computes

z= x-y

21.3.1 Parameters

N - INTEGER

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

Z - ARRAY OF COMPLEX

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

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  or y  .

INCX - INTEGER

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

Y - ARRAY OF COMPLEX

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

INCY - INTEGER

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