Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
A newer version of this document is available. Customers should click here to go to the newest version.
Visible to Intel only — GUID: GUID-22FF8717-BE45-461C-B3F4-1F32ABC7781C
Visible to Intel only — GUID: GUID-22FF8717-BE45-461C-B3F4-1F32ABC7781C
v?Acospi
Computes the inverse cosine of vector elements divided by π.
Syntax
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)
Include Files
- mkl_vml.f90
Input Parameters
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. |
Output Parameters
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. |
Description
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 |