Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
A newer version of this document is available. Customers should click here to go to the newest version.
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.
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 |
If element i in the result of v?Remainder is 0, its sign is that of ai.