v?Acos
v?Acos
Computes inverse cosine of vector elements.
Syntax
vsAcos
(
n
,
a
,
y
)
;
vsAcosI(n, a, inca, y, incy);
vmsAcos
(
n
,
a
,
y
,
mode
)
;
vmsAcosI(n, a, inca, y, incy, mode);
vdAcos
(
n
,
a
,
y
)
;
vdAcosI(n, a, inca, y, incy);
vmdAcos
(
n
,
a
,
y
,
mode
)
;
vmdAcosI(n, a, inca, y, incy, mode);
vcAcos
(
n
,
a
,
y
)
;
vcAcosI(n, a, inca, y, incy);
vmcAcos
(
n
,
a
,
y
,
mode
)
;
vmcAcosI(n, a, inca, y, incy, mode);
vzAcos
(
n
,
a
,
y
)
;
vzAcosI(n, a, inca, y, incy);
vmzAcos
(
n
,
a
,
y
,
mode
)
;
vmzAcosI(n, a, inca, y, incy, mode);
Include Files
- mkl.h
Input Parameters
Name | Type | Description |
---|---|---|
n | const int | Specifies the number of elements to be calculated. |
a | const float* for vsAcos , vmsAcos const double* for vdAcos , vmdAcos const MKL_Complex8* for vcAcos , vmcAcos const MKL_Complex16* for vzAcos , vmzAcos | 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 vsAcos , vmsAcos double* for vdAcos , vmdAcos MKL_Complex8* for vcAcos , vmcAcos MKL_Complex16* for vzAcos , vmzAcos | Pointer to an array that contains the output vector y . |
Description
The
v?Acos
function computes inverse cosine of vector elements.Argument | Result | VM Error Status | Exception |
---|---|---|---|
+0 | + π | ||
-0 | + π | ||
+1 | +0 | ||
-1 | + π | ||
|X| > 1 | QNAN | VML_STATUS_ERRDOM | INVALID |
+ ∞ | QNAN | VML_STATUS_ERRDOM | INVALID |
- ∞ | QNAN | VML_STATUS_ERRDOM | INVALID |
QNAN | QNAN | ||
SNAN | QNAN | INVALID |
See Special Value Notations for the conventions used in the table below.
RE(z) i · IM(z) | - ∞ | -X | -0 | +0 | +X | + ∞ | NAN |
---|---|---|---|---|---|---|---|
+i · ∞ | +3 · π · ∞ | + π · ∞ | + π · ∞ | + π · ∞ | + π · ∞ | + π · ∞ | QNAN-i · ∞ |
+i · Y | + π · ∞ | +0-i · ∞ | QNAN+i · QNAN | ||||
+i · 0 | + π · ∞ | + π · 0 | + π · 0 | +0-i · ∞ | QNAN+i · QNAN | ||
-i · 0 | + π · ∞ | + π · 0 | + π · 0 | +0+i · ∞ | QNAN+i · QNAN | ||
-i · Y | + π · ∞ | +0+i · ∞ | QNAN+i · QNAN | ||||
-i · ∞ | +3 π · ∞ | + π · ∞ | + π · ∞ | + π · ∞ | + π · ∞ | + π · ∞ | QNAN+i · ∞ |
+i · NAN | QNAN+i · ∞ | QNAN+i · QNAN | + π · QNAN | + π · QNAN | QNAN+i · QNAN | QNAN+i · ∞ | QNAN+i · QNAN |
Notes:
- raisesINVALIDexception when real or imaginary part of the argument isSNAN
- Acos(CONJ(z))=CONJ(Acos(z)).