I was just wondering...official javadoc says that it returns a double that is "equal to a mathematical integer", but then why shouldn't it return an int?
According to the same javadoc:
If the argument is NaN or an infinity or positive zero or negative zero, then the result is the same as the argument. Can't do that with an int.
The largest double value is also larger than the largest int, so it would have to be a long.
It's for precision. The double data-type has a 53 bit mantissa. Among other things that means that a double can represent all whole up to 2^53 without precision loss.
If you store such a large number in an integer you will get an overflow. Integers only have 32 bits.
Returning the integer as a double is the right thing to do here because it offers a much wider usefull number-range than a integer could.
So that error and other non integer values can correctly cascade through a series of calculations.
For instance, if you feed Not a Number (NaN) into Math.floor, it'll pass it along.
If it returned integer it couldn't pass these status or errors along, and you could get bad results from an earlier calculation that look good but are wrong after further processing.
What would you want it to return if you gave it a double bigger than the largest int or long?
(Admittedly if it's bigger than the largest long the precision will be low anyway - it may not be the nearest theoretical integer - but even so...)