Computes inverse hyperbolic cosine (nonnegative) of vector elements.
Syntax
Fortran:
call vsacosh( n, a, y )
call vmsacosh( n, a, y, mode )
call vdacosh( n, a, y )
call vmdacosh( n, a, y, mode )
call vcacosh( n, a, y )
call vmcacosh( n, a, y, mode )
call vzacosh( n, a, y )
call vmzacosh( n, a, y, mode )
C:
vsAcosh( n, a, y );
vmsAcosh( n, a, y, mode );
vdAcosh( n, a, y );
vmdAcosh( n, a, y, mode );
vcAcosh( n, a, y );
vmcAcosh( n, a, y, mode );
vzAcosh( n, a, y );
vmzAcosh( n, a, y, mode );
Include Files
The FORTRAN 77 interfaces are specified in the mkl_vml.f77 include file, the Fortran 90 interfaces are specified in the mkl_vml.f90 include file, and the C interfaces are specified in the mkl_vml_functions.h include file.
Input Parameters
Name |
Type |
Description |
|---|---|---|
n |
FORTRAN 77: INTEGER Fortran 90: INTEGER, INTENT(IN) C: const int |
Specifies the number of elements to be calculated. |
a |
FORTRAN 77: REAL for vsacosh, vmsacosh DOUBLE PRECISION for vdacosh, vmdacosh COMPLEX for vcacosh, vmcacosh DOUBLE COMPLEX for vzacosh, vmzacosh Fortran 90: REAL, INTENT(IN) for vsacosh, vmsacosh DOUBLE PRECISION, INTENT(IN) for vdacosh, vmdacosh COMPLEX, INTENT(IN) for vcacosh, vmcacosh DOUBLE COMPLEX, INTENT(IN) for vzacosh, vmzacosh C: const float* for vsAcosh, vmsAcosh const double* for vdAcosh, vmdAcosh const MKL_Complex8* for vcAcosh, vmcAcosh const MKL_Complex16* for vzAcosh, vmzAcosh |
FORTRAN: Array that specifies the input vector a. C: Pointer to an array that contains the input vector a. |
mode |
FORTRAN 77: INTEGER*8 Fortran 90: INTEGER(KIND=8), INTENT(IN) C: const MKL_INT64 |
Overrides global VML mode setting for this function call. See SetMode for possible values and their description. |
Output Parameters
Name |
Type |
Description |
|---|---|---|
y |
FORTRAN 77: REAL for vsacosh, vmsacosh DOUBLE PRECISION for vdacosh, vmdacosh COMPLEX for vcacosh, vmcacosh DOUBLE COMPLEX for vzacosh, vmzacosh Fortran 90: REAL, INTENT(OUT) for vsacosh, vmsacosh DOUBLE PRECISION, INTENT(OUT) for vdacosh, vmdacosh COMPLEX, INTENT(OUT) for vcacosh, vmcacosh DOUBLE COMPLEX, INTENT(OUT) for vzacosh, vmzacosh C: float* for vsAcosh, vmsAcosh double* for vdAcosh, vmdAcosh MKL_Complex8* for vcAcosh, vmcAcosh MKL_Complex16* for vzAcosh, vmzAcosh |
FORTRAN: Array that specifies the output vector y. C: Pointer to an array that contains the output vector y. |
Description
The v?Acosh function computes inverse hyperbolic cosine (nonnegative) of vector elements.
| Argument | Result | VML Error Status | Exception |
|---|---|---|---|
| +1 | +0 | ||
| X < +1 | QNAN | VML_STATUS_ERRDOM | INVALID |
| -∞ | QNAN | VML_STATUS_ERRDOM | INVALID |
| +∞ | +∞ | ||
| QNAN | QNAN | ||
| SNAN | QNAN | INVALID |
See Special Value Notations for the conventions used in the table below.
RE(z) i·IM(z) |
-∞
|
-X
|
-0
|
+0
|
+X
|
+∞
|
NAN
|
|---|---|---|---|---|---|---|---|
| +i·∞ |  |
+∞+i·π/2 | +∞+i·π/2 | +∞+i·π/2 | +∞+i·π/2 | +∞+i·π/4 | +∞+i·QNAN |
| +i·Y | +∞+i·π | +∞+i·0 | QNAN+i·QNAN |
||||
| +i·0 | +∞+i·π | +0+i·π/2 | +0+i·π/2 | +∞+i·0 | QNAN+i·QNAN |
||
| -i·0 | +∞+i·π | +0+i·π/2 | +0+i·π/2 | +∞+i·0 | QNAN+i·QNAN |
||
| -i·Y | +∞+i·π | +∞+i·0 | QNAN+i·QNAN |
||||
| -i·∞ |  |
+∞-i·π/2 | +∞-i·π/2 | +∞-i·π/2 | +∞-i·π/2 | +∞-i·π/4 | +∞+i·QNAN |
| +i·NAN | +∞+i·QNAN |
QNAN+i·QNAN |
QNAN+i·QNAN |
QNAN+i·QNAN |
QNAN+i·QNAN |
+∞+i·QNAN |
QNAN+i·QNAN |
Notes:
raises INVALID exception when real or imaginary part of the argument is SNAN
Acosh(CONJ(z))=CONJ(Acosh(z)).