Developer Reference for Intel® oneAPI Math Kernel Library for Fortran
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 (Sets a new mode for VM functions according to the mode parameter and stores the previous VM mode to oldmode.) 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 = a_{i} - n*b_{i}
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 |