Developer Reference for Intel® oneAPI Math Kernel Library for C

ID 766684
Date 7/13/2023
Public

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

Document Table of Contents

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

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 float* for vsRemainder

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 for possible values and their description.

Output Parameters

Name

Type

Description

y

float* for vsRemainder

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

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

See Also