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?NearbyInt
Computes a rounded integer value in the current rounding mode for each vector element.
Syntax
call vsnearbyint( n, a, y )
call vsnearbyinti(n, a, inca, y, incy)
call vmsnearbyint( n, a, y, mode )
call vmsnearbyinti(n, a, inca, y, incy, mode)
call vdnearbyint( n, a, y )
call vdnearbyinti(n, a, inca, y, incy)
call vmdnearbyint( n, a, y, mode )
call vmdnearbyinti(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 vdnearbyint, vmdnearbyint REAL, INTENT(IN) for vsnearbyint, vmsnearbyint DOUBLE PRECISION, INTENT(IN) for vdnearbyint, vmdnearbyint  |  
      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 vdnearbyint, vmdnearbyint REAL, INTENT(OUT) for vsnearbyint, vmsnearbyint DOUBLE PRECISION, INTENT(OUT) for vdnearbyint, vmdnearbyint  |  
      Array that specifies the output vector y.  |  
     
Description
The v?NearbyInt function computes a rounded integer value in a current rounding mode for each vector element.
| Argument | Result | Exception | 
|---|---|---|
| +0 | +0 | |
| -0 | -0 | |
| +∞ | +∞ | |
| -∞ | -∞ | |
| SNAN | QNAN | INVALID | 
| QNAN | QNAN |