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 |