Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
v?Expm1
vsExpm1 vdExpm1 vmsExpm1 vmdExpm1 Computes an exponential of vector elements decreased by 1.
Syntax
call vsexpm1(n, a, y)
call vsexpm1i(n, a, inca, y, incy)
call vmsexpm1(n, a, y, mode)
call vmsexpm1i(n, a, inca, y, incy, mode)
call vdexpm1(n, a, y)
call vdexpm1i(n, a, inca, y, incy)
call vdexpm1(n, a, y, mode)
call vmdexpm1i(n, a, inca, y, incy, mode)
Include Files
mkl_vml.f90
Input Parameters
Name |
Type |
Description |
|---|---|---|
n |
INTEGER , INTENT(IN) |
Specifies the number of elements to be calculated. |
a |
Fortran 77: DOUBLE PRECISION for vdexpm1 , vmdexpm1Fortran 90: REAL , INTENT(IN) for vsexpm1 , vmsexpm1Fortran 90: DOUBLE PRECISION , INTENT(IN) for vdexpm1 , vmdexpm1 |
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. |
Precision Overflow Thresholds for Expm1 Function
Data Type |
Threshold Limitations on Input Parameters |
|---|---|
single precision |
a[i] < Ln( FLT_MAX ) |
double precision |
a[i] < Ln( DBL_MAX ) |
Output Parameters
Name |
Type |
Description |
|---|---|---|
y |
Fortran 77: DOUBLE PRECISION for vdexpm1 , vmdexpm1Fortran 90: REAL , INTENT(OUT) for vsexpm1 , vmsexpm1Fortran 90: DOUBLE PRECISION , INTENT(OUT) for vdexpm1 , vmdexpm1 |
Array that specifies the output vector y . |
Description
The v?Expm1 function computes an exponential of vector elements decreased by 1.
Special Values for Real Function v?Expm1(x)
Argument |
Result |
VM Error Status |
Exception |
|---|---|---|---|
+0 |
+0 |
||
-0 |
+0 |
||
X > overflow |
|
VML_STATUS_OVERFLOW |
OVERFLOW |
|
|
||
|
-1 |
||
QNAN |
QNAN |
||
SNAN |
QNAN |
INVALID |