Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
v?Asinh
vsAsinh vdAsinh vcAsinh vzAsinh vmsAsinh vmdAsinh vmcAsinh vmzAsinh Computes inverse hyperbolic sine of vector elements.
Syntax
call vsasinh(n, a, y)
call vsasinhi(n, a, inca, y, incy)
call vmsasinh(n, a, y, mode)
call vmsasinhi(n, a, inca, y, incy, mode)
call vdasinh(n, a, y)
call vdasinhi(n, a, inca, y, incy)
call vmdasinh(n, a, y, mode)
call vmdasinhi(n, a, inca, y, incy, mode)
call vcasinh(n, a, y)
call vcasinhi(n, a, inca, y, incy)
call vmcasinh(n, a, y, mode)
call vmcasinhi(n, a, inca, y, incy, mode)
call vzasinh(n, a, y)
call vzasinhi(n, a, inca, y, incy)
call vmzasinh(n, a, y, mode)
call vmzasinhi(n, a, inca, y, incy, mode)
Include Files
mkl_vml.f90
Input Parameters
Name |
Type |
Description |
|---|---|---|
n |
Specifies the number of elements to be calculated. |
|
a |
Fortran 77: DOUBLE PRECISION for vdasinh , vmdasinhFortran 77: COMPLEX for vcasinh , vmcasinhFortran 77: DOUBLE COMPLEX for vzasinh , vmzasinhFortran 90: REAL , INTENT(IN) for vsasinh , vmsasinhFortran 90: DOUBLE PRECISION , INTENT(IN) for vdasinh , vmdasinhFortran 90: COMPLEX , INTENT(IN) for vcasinh , vmcasinhFortran 90: DOUBLE COMPLEX , INTENT(IN) for vzasinh , vmzasinh |
Array that specifies the input vector a . |
inca , incy |
INTEGER, INTENT(IN) |
Specifies increments for the elements of a and y . |
mode |
INTEGER(KIND=8) , INTENT(IN) |
Overrides 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 |
Fortran 77: DOUBLE PRECISION for vdasinh , vmdasinhFortran 77: COMPLEX for vcasinh , vmcasinhFortran 77: DOUBLE COMPLEX for vzasinh , vmzasinhFortran 90: REAL , INTENT(OUT) for vsasinh , vmsasinhFortran 90: DOUBLE PRECISION , INTENT(OUT) for vdasinh , vmdasinhFortran 90: COMPLEX , INTENT(OUT) for vcasinh , vmcasinhFortran 90: DOUBLE COMPLEX , INTENT(OUT) for vzasinh , vmzasinh |
Array that specifies the output vector y . |
Description
The v?Asinh function computes inverse hyperbolic sine of vector elements.
Special Values for Real Function v?Asinh(x)
Argument |
Result |
Exception |
|---|---|---|
+0 |
+0 |
|
-0 |
-0 |
|
|
|
|
|
|
|
QNAN |
QNAN |
|
SNAN |
QNAN |
INVALID |
See Special Value Notations for the conventions used in the table below.
Special Values for Complex Function v?Asinh(z)
RE(z) i · IM(z) |
|
-X |
-0 |
+0 |
+X |
|
NAN |
|---|---|---|---|---|---|---|---|
+i · ∞ |
|
|
|
|
|
|
|
+i · Y |
|
|
QNAN+i · QNAN |
||||
+i · 0 |
|
+0+i · 0 |
+0+i · 0 |
|
QNAN+i · QNAN |
||
-i · 0 |
|
-0-i · 0 |
+0-i · 0 |
|
QNAN-i · QNAN |
||
-i · Y |
|
|
QNAN+i · QNAN |
||||
-i · ∞ |
|
|
|
|
|
|
|
+i · NAN |
|
QNAN+i · QNAN |
QNAN+i · QNAN |
QNAN+i · QNAN |
QNAN+i · QNAN |
|
QNAN+i · QNAN |
Notes:
raises INVALID exception when real or imaginary part of the argument is SNAN
Asinh(CONJ(z))=CONJ(Asinh(z))
Asinh(-z)=-Asinh(z) .