Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

ID 766686
Date 11/07/2023
Public

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

Document Table of Contents

v?Remainder

Performs element by element computation of the remainder function on the elements of vector a and the corresponding elements of vector b.

Syntax

call vsremainder (n, a, b, y )

call vsremainderi(n, a, inca, b, incb, y, incy)

call vmsremainder (n, a, b, y, mode )

call vmsremainderi(n, a, inca, b, incb, y, incy, mode)

call vdremainder (n, a, b, y )

call vdremainderi(n, a, inca, b, incb, y, incy)

call vmdremainder (n, a, b, y, mode )

call vmdremainderi(n, a, inca, b, incb, y, incy, mode)

Include Files

  • mkl_vml.f90

Input Parameters

Name

Type

Description

n

INTEGER

Specifies the number of elements to be calculated.

a, b

REAL for vsRemainder

REAL for vmsRemainder

DOUBLE PRECISION for vdRemainder

DOUBLE PRECISION for vmdRemainder

Pointers to arrays containing the input vectors a and b.

inca, incb, incy

INTEGER, INTENT(IN)

Specifies increments for the elements of a, b, and y.

mode

INTEGER (KIND=8)

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

Output Parameters

Name

Type

Description

y

REAL for vsRemainder

REAL for vmsRemainder

DOUBLE PRECISION for vdRemainder

DOUBLE PRECISION for vmdRemainder

Pointer to an array containing the output vector y.

Description

Computes the remainder of each element of vector a, with respect to the corresponding elements of vector b: compute the values of n such that

n = ai - n*bi

where n is the integer nearest to the exact value of ai/bi. If two integers are equally close to ai/bi, n is the even one. If n is zero, it has the same sign as ai.

Special values for Real Function v?Remainder(x, y)
Argument 1 Argument 2 Result VM Error Status Exception
x not NAN ±0 NAN VML_STATUS_DOM INVALID
±∞ y not NAN NAN   INVALID
±0 y 0, not NAN ±0    
x finite ±∞ x   UNDERFLOW if x is subnormal
NAN y NAN    
x NAN NAN    
NOTE:

If element i in the result of v?Remainder is 0, its sign is that of ai.

See Also