v?Arg
v?Arg
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 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.
RE(z) i · IM(z) | - ∞ | -X | -0 | +0 | +X | + ∞ | NAN |
---|---|---|---|---|---|---|---|
+i · ∞ | +3 · π | + π | + π | + π | + π | + π | NAN |
+i · Y | + π | + π | + π | +0 | NAN | ||
+i · 0 | + π | + π | + π | +0 | +0 | +0 | NAN |
-i · 0 | - π | - π | - π | -0 | -0 | -0 | NAN |
-i · Y | - π | - π | - π | -0 | NAN | ||
-i · ∞ | -3 · π | - π | - π | - π | - π | - π | NAN |
+i · NAN | NAN | NAN | NAN | NAN | NAN | NAN | NAN |
Notes:
- raisesINVALIDexception when real or imaginary part of the argument isSNAN
- Arg(z)=Atan2(IM(z),RE(z)).