Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
A newer version of this document is available. Customers should click here to go to the newest version.
v?Log1p
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  |  
      DOUBLE PRECISION for vdlog1p, vmdlog1p REAL, INTENT(IN) for vslog1p, vmslog1p 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 for possible values and their description.  |  
     
Output Parameters
Name  |  
      Type  |  
      Description  |  
     
|---|---|---|
y  |  
      DOUBLE PRECISION for vdlog1p, vmdlog1p REAL, INTENT(OUT) for vslog1p, vmslog1p 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.
| 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 |