Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
v?Round
vsRound vmsRound vdRound vmdRound Computes a value rounded to the nearest integer for each vector element.
Syntax
call vsround ( n , a , y )
call vsroundi(n, a, inca, y, incy)
call vmsround ( n , a , y , mode )
call vmsroundi(n, a, inca, y, incy, mode)
call vdround ( n , a , y )
call vdroundi(n, a, inca, y, incy)
call vmdround ( n , a , y , mode )
call vmdroundi(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 vdround , vmdroundFortran 90: REAL , INTENT(IN) for vsround , vmsroundFortran 90: DOUBLE PRECISION , INTENT(IN) for vdround , vmdround |
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 vdround , vmdroundFortran 90: REAL , INTENT(OUT) for vsround , vmsroundFortran 90: DOUBLE PRECISION , INTENT(OUT) for vdround , vmdround |
Array that specifies the output vector y . |
Description
The function computes a value rounded to the nearest integer for each vector element. Input elements that are halfway between two consecutive integers are always rounded away from zero regardless of the rounding mode.
Special Values for Real Function v?Round(x)
Argument |
Result |
Exception |
|---|---|---|
+0 |
+0 |
|
-0 |
-0 |
|
|
|
|
|
|
|
SNAN |
QNAN |
INVALID |
QNAN |
QNAN |