fdim
From cppreference.com
Defined in header <math.h>
|
||
float fdimf( float x, float y ); |
(1) | (since C99) |
double fdim( double x, double y ); |
(2) | (since C99) |
long double fdiml( long double x, long double y ); |
(3) | (since C99) |
Defined in header <tgmath.h>
|
||
#define fdim( x, y ) |
(4) | (since C99) |
1-3) Returns the positive difference between x and y, that is, if x>y, returns x-y, otherwise (if x≤y), returns +0.
4) Type-generic macro: If any argument has type long double,
fdiml
is called. Otherwise, if any argument has integer type or has type double, fdim
is called. Otherwise, fdimf
is called.Parameters
x, y | - | floating point value |
Return value
If successful, returns the positive difference between x and y.
If a range error due to overflow occurs, +HUGE_VAL
, +HUGE_VALF
, or +HUGE_VALL
is returned.
If a range error due to underflow occurs, the correct value (after rounding) is returned.
Error handling
Errors are reported as specified in math_errhandling.
If the implementation supports IEEE floating-point arithmetic (IEC 60559),
- If either argument is NaN, NaN is returned
Notes
Equivalent to fmax(x-y, 0) except for the NaN handling requirements.