Developer Reference for Intel® oneAPI Math Kernel Library for C
v?Acospi
Computes the inverse cosine of vector elements divided by π .
Syntax
vhAcospi ( n , a , y );
vhAcospiI(n, a, inca, y, incy);
vmhAcospi ( n , a , y , mode );
vmhAcospiI(n, a, inca, y, incy, mode);
vsAcospi ( n , a , y );
vsAcospiI(n, a, inca, y, incy);
vmsAcospi ( n , a , y , mode );
vmsAcospiI(n, a, inca, y, incy, mode);
vdAcospi ( n , a , y );
vdAcospiI(n, a, inca, y, incy);
vmdAcospi ( n , a , y , mode );
vmdAcospiI(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 _Float16* for vhAcospi const float* for vsAcospi const _Float16* for vmhAcospi const float* for vmsAcospi const double* for vdAcospi const double* for vmdAcospi |
Pointer to the array containing the input vector a . |
inca , incy |
const MKL_INT |
Specifies increments for the elements of a and y . |
mode |
const MKL_INT64 |
Overrides the 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 |
_Float16* for vhAcospi float* for vsAcospi _Float16* for vmhAcospi float* for vmsAcospi double* for vdAcospi double* 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:
Special values for Real Function v?Acospi(x)
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 |