# remainder()

Anonymous contributor
Anonymous contributor
Published Dec 3, 2022
Contribute to Docs

The `remainder()` function returns the floating-point remainder resulting from the division of the arguments provided (rounded to the nearest number).

## Syntax

``remainder(numerator, denominator)``

The data type of the return value will either be a `double`, `float`, or `long double`. Combinations of these types will return a `double`.

The remainder is `numerator - n \* denominator`, where `n` is the result of `numerator / denominator` rounded to the nearest integral value.

• If `n` is a halfway case, it is rounded toward the nearest even number (e.g., 2.5 becomes 2, 5.5 becomes 6).
• If the return value is zero, it will have the same sign as `numerator`.
• If `denominator` is zero, either zero will be returned or a domain error will be thrown (depending on the C++ implementation being used).

## Example

```#include <iostream>#include <cmath>using namespace std;
int main () {  cout << "Remainder of 33.2 / 13 is " << remainder(33.2, 13) << endl;  cout << "Remainder of 9 / 2 is " << remainder(9, 2) << endl;  return 0;}```

This produces the following output:

`Remainder of 33.2 / 13 is -5.8Remainder of 9 / 2 is 1`

In the first call to the `remainder()` function, the `n` value is 33.2 / 13 (2.55) which is rounded to the nearest integral value, 3. This is then multiplied by the denominator, 13, and the product is subtracted from the numerator, 33.2. The other call to the `remainder()` function involves a halfway case, where the `n` value (9 / 2) equates to 4.5 and is rounded down to 4, the nearest even number.

## Codebyte Example

The following example is runnable and produces the remainder of 7.3 / 2:

`Favicon IconCodeOutputLoading...`

## All contributors

Looking to contribute?