BigIntegerMath sqrt() function | Guava | Java
The method sqrt(BigInteger x, RoundingMode mode) of Guava’s BigIntegerMath class returns the square root of x, rounded with the specified rounding mode.
public static BigInteger sqrt(BigInteger x, RoundingMode mode)
Parameters: This method takes the following parameters:
- x : The BigInteger number whose square-root is to be found.
- mode : The rounding mode for calculating the square-root.
Return Value: This method returns the square root of x, rounded with the specified rounding mode.
Exceptions: This method throws following exceptions:
- IllegalArgumentException: if x < 0.
- ArithmeticException: if mode is RoundingMode.UNNECESSARY and sqrt(x) is not an integer.
|CEILING||Rounding mode to round towards positive infinity.|
|DOWN||Rounding mode to round towards zero.|
|FLOOR||Rounding mode to round towards negative infinity.|
|HALF_DOWN||Rounding mode to round towards “nearest neighbor” unless both neighbors are equidistant, in which case round down.|
|HALF_EVEN||Rounding mode to round towards the “nearest neighbor” unless both neighbors are equidistant, in which case, round towards the even neighbor.|
|HALF_UP||Rounding mode to round towards “nearest neighbor” unless both neighbors are equidistant, in which case round up.|
|UNNECESSARY||Rounding mode to assert that the requested operation has an exact result, hence no rounding is necessary.|
|UP||Rounding mode to round away from zero.|
Below examples illustrates the BigIntegerMath.sqrt() method:
Square root of 226with HALF_EVEN rounding mode is: 15 Square root of 154with FLOOR rounding mode is: 12
Exception: java.lang.IllegalArgumentException: x (-65) must be >= 0