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?Fmod

The v?Fmod function performs element by element computation of the modulus function of vector a with respect to vector b.

Syntax

call vsfmod (n, a, b, y )

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

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

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

call vdfmod (n, a, b, y )

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

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

call vmdfmodi(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 vsFmod

REAL for vmsFmod

DOUBLE PRECISION for vdFmod

DOUBLE PRECISION for vmdFmod

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 vsFmod

REAL for vmsFmod

DOUBLE PRECISION for vdFmod

DOUBLE PRECISION for vmdFmod

Pointer to an array containing the output vector y.

Description

The v?Fmod function computes the modulus function of each element of vector a, with respect to the corresponding elements of vector b:

ai - bi*trunc(ai/bi)

In general, the modulus function fmod (ai, bi) returns the value ai - n*bi for some integer n such that if bi is nonzero, the result has the same sign as ai and a magnitude less than the magnitude of bi.

Special values for Real Function v?Fmod(x, y)
Argument 1 Argument 2 Result VM Error Status Exception
x not NAN ±0 NAN VML_STATUS_SING INVALID
±∞ y not NAN NAN VML_STATUS_SING 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?Fmod is 0, its sign is that of ai.

See Also