Developer Reference for Intel® oneAPI Math Kernel Library for C
v?Expm1
vsExpm1 vdExpm1 vmsExpm1 vmdExpm1 Computes an exponential of vector elements decreased by 1.
Syntax
vhExpm1 ( n , a , y ) ;
vhExpm1I(n, a, inca, y, incy);
vmhExpm1 ( n , a , y , mode ) ;
vmhExpm1I(n, a, inca, y, incy, mode);
vsExpm1 ( n , a , y ) ;
vsExpm1I(n, a, inca, y, incy);
vmsExpm1 ( n , a , y , mode ) ;
vmsExpm1I(n, a, inca, y, incy, mode);
vdExpm1 ( n , a , y ) ;
vdExpm1I(n, a, inca, y, incy);
vmdExpm1 ( n , a , y , mode ) ;
vmdExpm1I(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 vhExpm1 , vmhExpm1 const float* for vsExpm1 , vmsExpm1 const double* for vdExpm1 , vmdExpm1 |
Pointer to an array that contains the input vector a . |
inca , incy |
const MKL_INT |
Specifies increments for the elements of a and y . |
mode |
const MKL_INT64 |
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 |
_Float16* for vhExpm1 , vmhExpm1 float* for vsExpm1 , vmsExpm1 double* for vdExpm1 , vmdExpm1 |
Pointer to an array that contains 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 |