v?NearbyInt

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

Syntax

Fortran:

call vsnearbyint( n, a, y )

call vdnearbyint( n, a, y )

vsNearbyInt( n, a, y );

vdNearbyInt( n, a, y );

Include Files

The FORTRAN 77 interfaces are specified in the mkl_vml.f77 include file, the Fortran 95 interfaces are specified in the mkl_vml.f90 include file, and the C interfaces are specified in the mkl_vml_functions.h include file.

Input Parameters

Name	Type	Description
n	FORTRAN 77: INTEGER Fortran 90: INTEGER, INTENT(IN) C: const int	Specifies the number of elements to be calculated.
a	FORTRAN 77: REAL for vsnearbyint DOUBLE PRECISION for vdnearbyint Fortran 90: REAL, INTENT(IN) for vsnearbyint DOUBLE PRECISION, INTENT(IN) for vdnearbyint C: const float* for vsNearbyInt const double* for vdNearbyInt	FORTRAN: Array that specifies the input vector a. C: Pointer to an array that contains the input vector a.

Name

Type

Description

FORTRAN 77: INTEGER

Fortran 90: INTEGER, INTENT(IN)

C: const int

Specifies the number of elements to be calculated.

FORTRAN 77: REAL for vsnearbyint

DOUBLE PRECISION for vdnearbyint

Fortran 90: REAL, INTENT(IN) for vsnearbyint

DOUBLE PRECISION, INTENT(IN) for vdnearbyint

C: const float* for vsNearbyInt

const double* for vdNearbyInt

FORTRAN: Array that specifies the input vector a.

C: Pointer to an array that contains the input vector a.

Output Parameters

Name	Type	Description
y	FORTRAN 77: REAL for vsnearbyint DOUBLE PRECISION for vdnearbyint Fortran 90: REAL, INTENT(OUT) for vsnearbyint DOUBLE PRECISION, INTENT(OUT) for vdnearbyint C: float* for vsNearbyInt double* for vdNearbyInt	FORTRAN: Array that specifies the output vector y. C: Pointer to an array that contains the output vector y.

Name

Type

Description

FORTRAN 77: REAL for vsnearbyint

DOUBLE PRECISION for vdnearbyint

Fortran 90: REAL, INTENT(OUT) for vsnearbyint

DOUBLE PRECISION, INTENT(OUT) for vdnearbyint

C: float* for vsNearbyInt

double* for vdNearbyInt

FORTRAN: Array that specifies the output vector y.

C: 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.

Halfway values, that is, 0.5, -1.5, and the like, are rounded off towards even values.

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