v?Remainder

Developer Reference for Intel® oneAPI Math Kernel Library for C

Download PDF

ID 766684

Date 4/28/2026

Version

Public

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

vhRemainder ( n , a , b , y );

vhRemainderI(n, a, inca, b, incb, y, incy);

vmhRemainder ( n , a , b , y , mode );

vmhRemainderI(n, a, inca, b, incb, y, incy, mode);

vsRemainder ( n , a , b , y );

vsRemainderI(n, a, inca, b, incb, y, incy);

vmsRemainder ( n , a , b , y , mode );

vmsRemainderI(n, a, inca, b, incb, y, incy, mode);

vdRemainder ( n , a , b , y );

vdRemainderI(n, a, inca, b, incb, y, incy);

vmdRemainder ( n , a , b , y , mode );

vmdRemainderI(n, a, inca, b, incb, y, incy, mode);

Include Files

mkl.h

Input Parameters

Name	Type	Description
`n`	const MKL_INT	Specifies the number of elements to be calculated.
`a, b`	const _Float16* for `vhRemainder` const float* for `vsRemainder` const _Float16* for `vmhRemainder` const float* for `vmsRemainder` const double* for `vdRemainder` const double* for `vmdRemainder`	Pointers to arrays containing the input vectors `a` and `b` .
`inca` , `incb` , `incy`	const MKL_INT	Specifies increments for the elements of `a` , `b` , and `y` .
`mode`	const MKL_INT64	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`	_Float16* for `vhRemainder` float* for `vsRemainder` _Float16* for `vmhRemainder` float* for `vmsRemainder` double* for `vdRemainder` double* 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 .

NOTE:

Div
Fmod

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 C

v?Remainder

Syntax

Include Files

Input Parameters

Output Parameters

Description