Why does Math.floor return a double?

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...)

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.

Others have told you the why, I'm going to tell you how to round correctly given you want to do this. If you are only going to use positive numbers, then you can use this statement:

int a=(int) 1.5;

However, the (int) always rounds towards 0. Thus, if you want to do a negative number:

int a=(int) -1.5; //Equal to -1

In my case, I didn't want to do this. I used the following code to do the rounding, and it seems to handle all of the edge cases well:

private static long floor(double a)
{
    return (int) Math.floor(a);
}

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.