Intel® oneAPI Math Kernel Library Developer Reference - Fortran
Computes the inverse cosine of vector elements divided by π.
call vsacospi (n, a, y)
call vsacospii(n, a, inca, y, incy)
call vmsacospi (n, a, y, mode)
call vmsacospii(n, a, inca, y, incy, mode)
call vdacospi (n, a, y)
call vdacospii(n, a, inca, y, incy)
call vmdacospi (n, a, y, mode)
call vmdacospii(n, a, inca, y, incy, mode)
Name |
Type |
Description |
|---|---|---|
n |
INTEGER |
Specifies the number of elements to be calculated. |
a |
REAL for vsacospi REAL for vmsacospi DOUBLE PRECISION for vdacospi DOUBLE PRECISION for vmdacospi |
Pointer to the array containing the input vector a. |
inca, incy |
INTEGER, INTENT(IN) |
Specifies increments for the elements of a and y. |
mode |
INTEGER (KIND=8) |
Overrides the global VM mode setting for this function call. See vmlSetMode for possible values and their description. |
Name |
Type |
Description |
|---|---|---|
y |
REAL for vsacospi REAL for vmsacospi DOUBLE PRECISION for vdacospi DOUBLE PRECISION for vmdacospi |
Pointer to an array containing the output vector y. |
The v?Acospi function computes the inverse cosine of vector elements divided by π. For an argument x, the function computes acos(x)/π.
See Special Value Notations for the conventions used in this table:
| Argument | Result | VM Error Status | Exception |
|---|---|---|---|
| +0 | +1/2 | ||
| -0 | +1/2 | ||
| +1 | +0 | ||
| -1 | +1 | ||
| |x| > 1 | QNAN | VML_STATUS_ERRDOM | INVALID |
| +∞ | QNAN | VML_STATUS_ERRDOM | INVALID |
| - ∞ | QNAN | VML_STATUS_ERRDOM | INVALID |
| QNAN | QNAN | ||
| SNAN | QNAN | INVALID |