v?Rint

Computes a rounded integer value in the current rounding mode for each vector element with inexact result exception raised for each changed value.

Syntax

Fortran:

call vsrint( n, a, y )

call vdrint( n, a, y )

vsRint( n, a, y );

vdRint( n, a, y );

Include Files

The FORTRAN 77 interfaces are specified in the mkl_vml.f77 include file, the Fortran 90 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 vsrint DOUBLE PRECISION for vdrint Fortran 90: REAL, INTENT(IN) for vsrint DOUBLE PRECISION, INTENT(IN) for vdrint C: const float* for vsRint const double* for vdRint	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 vsrint

DOUBLE PRECISION for vdrint

Fortran 90: REAL, INTENT(IN) for vsrint

DOUBLE PRECISION, INTENT(IN) for vdrint

C: const float* for vsRint

const double* for vdRint

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 vsrint DOUBLE PRECISION for vdrint Fortran 90: REAL, INTENT(OUT) for vsrint DOUBLE PRECISION, INTENT(OUT) for vdrint C: float* for vsRint double* for vdRint	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 vsrint

DOUBLE PRECISION for vdrint

Fortran 90: REAL, INTENT(OUT) for vsrint

DOUBLE PRECISION, INTENT(OUT) for vdrint

C: float* for vsRint

double* for vdRint

FORTRAN: Array that specifies the output vector y.

C: 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 resulting mode affects the results computed for inputs that fall half-way between consecutive integres. For example:

f(0.5) = 0, for rounding modes set to round to nearest round toward zero or to minus infinity.
f(0.5) = 1, for rounding modes set to plus infinity.
f(-1.5) = -2, for rounding modes set to round to nearest or to minus infinity.
f(-1.5) = -1, for rounding modes set to round toward zero or to plus infinity.

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