Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
v?Log1p
vsLog1p vmsLog1p vdLog1p vmdLog1p Computes a natural logarithm of vector elements that are increased by 1.
Syntax
call vslog1p(n, a, y)
call vslog1pi(n, a, inca, y, incy)
call vmslog1p(n, a, y, mode)
call vmslog1pi(n, a, inca, y, incy, mode)
call vdlog1p(n, a, y)
call vdlog1pi(n, a, inca, y, incy)
call vmdlog1p(n, a, y, mode)
call vmdlog1pi(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 vdlog1p , vmdlog1pFortran 90: REAL , INTENT(IN) for vslog1p , vmslog1pFortran 90: DOUBLE PRECISION , INTENT(IN) for vdlog1p , vmdlog1p |
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 vdlog1p , vmdlog1pFortran 90: REAL , INTENT(OUT) for vslog1p , vmslog1pFortran 90: DOUBLE PRECISION , INTENT(OUT) for vdlog1p , vmdlog1p |
Array that specifies the output vector y . |
Description
The v?Log1p function computes a natural logarithm of vector elements that are increased by 1.
Special Values for Real Function v?Log1p(x)
Argument |
Result |
VM Error Status |
Exception |
|---|---|---|---|
-1 |
|
VML_STATUS_SING |
ZERODIVIDE |
X < -1 |
QNAN |
VML_STATUS_ERRDOM |
INVALID |
+0 |
+0 |
||
-0 |
-0 |
||
|
QNAN |
VML_STATUS_ERRDOM |
INVALID |
|
|
||
QNAN |
QNAN |
||
SNAN |
QNAN |
INVALID |