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 |