remquof

Applicability

Product	Supported
Atlas 350 Accelerator Card	√
Atlas A3 training product/Atlas A3 inference product	x
Atlas A2 training product/Atlas A2 inference product	x
Atlas 200I/500 A2 inference product	x
Atlas inference product AI Core	x
Atlas inference product Vector Core	x
Atlas training product	x

Function Usage

Obtains the remainder r of input x divided by y. In r=x - ny, n is the quotient of x divided by y, and n is rounded to the nearest integer. If the floating-point result of x divided by y is exactly halfway between two integers, the quotient is rounded to the even integer. The quotient is then stored in the variable pointed to by the pointer quo.

Prototype

inline float remquof(float x, float y, int *quo)

Parameters

**Table 1** Parameters
Parameter	Input/Output	Description
x	Input	Source operand.
y	Input	Source operand.
quo	Output	Unified Buffer, Global Memory, or stack address, which is used to store the quotient of the division operation.

Returns

The remainder of input x divided by y.

If either x or y is nan, the return value is nan.
If y is 0, the return value is nan.
If x is inf or -inf, the return value is nan.
If x is a finite value and y is inf or -inf, the return value is x.

Restrictions

For SIMT programming, this API is not supported.

Header File to Be Included

To use this API, the simt_api/math_functions.h header file must be included.

#include "simt_api/math_functions.h"

Examples

For SIMD and SIMT programming:

In SIMD and SIMT programming, the address space qualifier must be explicitly used to indicate the address space. __gm__ indicates the Global Memory memory space, and __ubuf__ indicates the Unified Buffer memory space. No address space qualifier is required for the stack space.

__simt_vf__ __launch_bounds__(1024) inline void KernelRemQuo(__gm__ float* dst, __gm__ float* x, __gm__ float* y, __gm__ int* quo)
{
    int idx = threadIdx.x + blockIdx.x * blockDim.x;
    dst[idx] = remquof(x[idx], y[idx], quo + idx);
 }

Parent topic: Mathematical Functions