Intel® Math Kernel Library 2018 Developer Reference - C

v?Rint

Computes a rounded integer value in the current rounding mode.

Syntax

vsRint( n, a, y );

vmsRint( n, a, y, mode );

vdRint( n, a, y );

vmdRint( n, a, y, mode );

Include Files

Input Parameters

Name

Type

Description

n

const MKL_INT

Specifies the number of elements to be calculated.

a

const float* for vsRint, vmsRint

const double* for vdRint, vmdRint

Pointer to an array that contains the input vector a.

mode

const MKL_INT64

Overrides global VM mode setting for this function call. See vmlSetMode for possible values and their description.

Output Parameters

Name

Type

Description

y

float* for vsRint, vmsRint

double* for vdRint, vmdRint

Pointer to an array that contains the output vector y.

Description

The v?Rint function computes a rounded floating-point integer value using the current rounding mode for each vector element.

The rounding mode affects the results computed for inputs that fall between consecutive integers. For example:

Special Values for Real Function v?Rint(x)
Argument Result Exception
+0 +0  
-0 -0  
+ +  
- -  
SNAN QNAN INVALID
QNAN QNAN