Developer Reference for Intel® oneAPI Math Kernel Library for C
v?NearbyInt
vsNearbyInt vmsNearbyInt vdNearbyInt vmdNearbyInt Computes a rounded integer value in the current rounding mode for each vector element.
Syntax
vhNearbyInt ( n , a , y ) ;
vhNearbyIntI(n, a, inca, y, incy);
vmhNearbyInt ( n , a , y , mode ) ;
vmhNearbyIntI(n, a, inca, y, incy, mode);
vsNearbyInt ( n , a , y ) ;
vsNearbyIntI(n, a, inca, y, incy);
vmsNearbyInt ( n , a , y , mode ) ;
vmsNearbyIntI(n, a, inca, y, incy, mode);
vdNearbyInt ( n , a , y ) ;
vdNearbyIntI(n, a, inca, y, incy);
vmdNearbyInt ( n , a , y , mode ) ;
vmdNearbyIntI(n, a, inca, y, incy, mode);
Include Files
mkl.h
Input Parameters
Name |
Type |
Description |
|---|---|---|
n |
const MKL_INT |
Specifies the number of elements to be calculated. |
a |
const _Float16* for vhNearbyInt , vmhNearbyInt const float* for vsNearbyInt , vmsNearbyInt const double* for vdNearbyInt , vmdNearbyInt |
Pointer to an array that contains the input vector a . |
inca , incy |
const MKL_INT |
Specifies increments for the elements of a and y . |
mode |
const MKL_INT64 |
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 |
_Float16* for vhNearbyInt , vmhNearbyInt float* for vsNearbyInt , vmsNearbyInt double* for vdNearbyInt , vmdNearbyInt |
Pointer to an array that contains 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 |