Developer Reference for Intel® oneAPI Math Kernel Library for C
v?Arg
vcArg vmcArg vzArg vmzArg Computes argument of vector elements.
Syntax
vcArg ( n , a , y ) ;
vcArgI(n, a, inca, y, incy);
vmcArg ( n , a , y , mode ) ;
vmcArgI(n, a, inca, y, incy, mode);
vzArg ( n , a , y ) ;
vzArgI(n, a, inca, y, incy);
vmzArg ( n , a , y , mode ) ;
vmzArgI(n, a, inca, y, incy, mode);
Include Files
mkl.h
Input Parameters
Name |
Type |
Description |
|---|---|---|
n |
const MKL_INT |
Specifies the number of elements to be calculated. |
a |
const MKL_Complex8* for vcArg , vmcArg const MKL_Complex16* for vzArg , vmcArg |
Pointer to an array that contains the input vector a . |
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 (Sets a new mode for VM functions according to the mode parameter and stores the previous VM mode to oldmode.) for possible values and their description. |
Output Parameters
Name |
Type |
Description |
|---|---|---|
y |
float* for vcArg , vmcArg double* for vzArg , vmcArg |
Pointer to an array that contains the output vector y . |
Description
The v?Arg function computes argument of vector elements.
See Special Value Notations for the conventions used in the table below.
Special Values for Complex Function v?Arg(z)
RE(z) i · IM(z) |
|
-X |
-0 |
+0 |
+X |
|
NAN |
|---|---|---|---|---|---|---|---|
+i · ∞ |
+3 · π /4 |
|
|
|
|
|
NAN |
+i · Y |
|
|
|
+0 |
NAN |
||
+i · 0 |
|
|
|
+0 |
+0 |
+0 |
NAN |
-i · 0 |
|
|
|
-0 |
-0 |
-0 |
NAN |
-i · Y |
|
|
|
-0 |
NAN |
||
-i · ∞ |
-3 · π /4 |
|
|
|
|
|
NAN |
+i · NAN |
NAN |
NAN |
NAN |
NAN |
NAN |
NAN |
NAN |
Notes:
raises INVALID exception when real or imaginary part of the argument is SNAN
\(Arg(z)=Atan2(IM(z),RE(z))\) .