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) .