Remainder Functions (The GNU C Library)

#### 20.8.4 Remainder Functions ¶

The functions in this section compute the remainder on division of two floating-point numbers. Each is a little different; pick the one that suits your problem.

Function: `double` fmod `(double numerator, double denominator)` ¶
Function: `float` fmodf `(float numerator, float denominator)` ¶
Function: `long double` fmodl `(long double numerator, long double denominator)` ¶
Function: `_FloatN` fmodfN `(_FloatN numerator, _FloatN denominator)` ¶
Function: `_FloatNx` fmodfNx `(_FloatNx numerator, _FloatNx denominator)` ¶

  Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.

  These functions compute the remainder from the division of numerator by denominator. Specifically, the return value is `numerator - n * denominator`, where n is the quotient of numerator divided by denominator, rounded towards zero to an integer. Thus, `fmod (6.5, 2.3)` returns `1.9`, which is `6.5` minus `4.6`.

  The result has the same sign as the numerator and has magnitude less than the magnitude of the denominator.

  If denominator is zero, `fmod` signals a domain error.

Function: `double` remainder `(double numerator, double denominator)` ¶
Function: `float` remainderf `(float numerator, float denominator)` ¶
Function: `long double` remainderl `(long double numerator, long double denominator)` ¶
Function: `_FloatN` remainderfN `(_FloatN numerator, _FloatN denominator)` ¶
Function: `_FloatNx` remainderfNx `(_FloatNx numerator, _FloatNx denominator)` ¶

  Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.

  These functions are like `fmod` except that they round the internal quotient n to the nearest integer instead of towards zero to an integer. For example, `remainder (6.5, 2.3)` returns `-0.4`, which is `6.5` minus `6.9`.

  The absolute value of the result is less than or equal to half the absolute value of the denominator. The difference between `fmod (numerator, denominator)` and `remainder (numerator, denominator)` is always either denominator, minus denominator, or zero.

  If denominator is zero, `remainder` signals a domain error.

Function: `double` drem `(double numerator, double denominator)` ¶
Function: `float` dremf `(float numerator, float denominator)` ¶
Function: `long double` dreml `(long double numerator, long double denominator)` ¶

  Preliminary: | MT-Safe | AS-Safe | AC-Safe | See POSIX Safety Concepts.

  This function is another name for `remainder`.