Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
v?NearbyInt
vsNearbyInt vmsNearbyInt vdNearbyInt vmdNearbyInt 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 |
Specifies the number of elements to be calculated. |
|
a |
Fortran 77: DOUBLE PRECISION for vdnearbyint , vmdnearbyintFortran 90: REAL , INTENT(IN) for vsnearbyint , vmsnearbyintFortran 90: 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 |
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 vdnearbyint , vmdnearbyintFortran 90: REAL , INTENT(OUT) for vsnearbyint , vmsnearbyintFortran 90: 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.
Special Values for Real Function v?NearbyInt(x)
Argument |
Result |
Exception |
|---|---|---|
+0 |
+0 |
|
-0 |
-0 |
|
|
|
|
|
|
|
SNAN |
QNAN |
INVALID |
QNAN |
QNAN |