Visible to Intel only — GUID: GUID-D88D4F44-4CFE-4CD0-81A2-028E04E537AF
Visible to Intel only — GUID: GUID-D88D4F44-4CFE-4CD0-81A2-028E04E537AF
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.
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 |
If element i in the result of v?Fmod is 0, its sign is that of ai.