Developer Reference for Intel® oneAPI Math Kernel Library for C

ID 766684
Date 3/22/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

v?NearbyInt

Computes a rounded integer value in the current rounding mode for each vector element.

Syntax

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 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 for possible values and their description.

Output Parameters

Name

Type

Description

y

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