floor, floorf, floorl

Parameters

Return value

If no errors occur, the largest integer value not greater than arg , that is ⌊arg⌋ , is returned.

Return value

Argument

Error handling

Errors are reported as specified in math_errhandling .

If the implementation supports IEEE floating-point arithmetic (IEC 60559):

• The current rounding mode has no effect.
• If arg is ±∞, it is returned, unmodified.
• If arg is ±0, it is returned, unmodified.
• If arg is NaN, NaN is returned.

Notes

FE_INEXACT may be (but isn't required to be) raised when rounding a non-integer finite value.

The largest representable floating-point values are exact integers in all standard floating-point formats, so this function never overflows on its own; however the result may overflow any integer type (including intmax_t ), when stored in an integer variable.

Example

#include <math.h>
#include <stdio.h>
 
int main(void)
{
    printf("floor(+2.7) = %+.1f\n", floor(2.7));
    printf("floor(-2.7) = %+.1f\n", floor(-2.7));
    printf("floor(-0.0) = %+.1f\n", floor(-0.0));
    printf("floor(-Inf) = %+f\n",   floor(-INFINITY));
}

floor(+2.7) = +2.0
floor(-2.7) = -3.0
floor(-0.0) = -0.0
floor(-Inf) = -inf

References

See also