v?Remainder

Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

Download PDF

ID 766686

Date 3/31/2023

Version

Public

A newer version of this document is available. Customers should click here to go to the newest version.

Visible to Intel only — GUID: GUID-C08469E1-F5B9-49BD-BDB3-C5714D9EE80B

View Details

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`.

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 a_i/b_i. If two integers are equally close to a_i/b_i, n is the even one. If n is zero, it has the same sign as a_i.

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

NOTE:

If element i in the result of v?Remainder is 0, its sign is that of a_i.

Parent topic: Arithmetic Functions

Select Your Language

Using Intel.com Search

Quick Links

Recent Searches

Advanced Search

Only search in

Developer Reference for Intel® oneAPI Math Kernel Library for Fortran

v?Remainder

See Also