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.
Syntax:
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.
Enum RoundingMode
Enum Constant |
Description |
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:
Example 1:
import java.math.*;
import com.google.common.math.BigIntegerMath;
class GFG {
public static void main(String args[])
{
BigInteger x1 = BigInteger.valueOf( 226 );
BigInteger ans1 = BigIntegerMath
.sqrt(x1,
RoundingMode.HALF_EVEN);
System.out.println( "Square root of " + x1
+ "with HALF_EVEN rounding mode is: "
+ ans1);
BigInteger x2 = BigInteger.valueOf( 154 );
BigInteger ans2 = BigIntegerMath
.sqrt(x2,
RoundingMode.FLOOR);
System.out.println( "Square root of " + x2
+ "with FLOOR rounding mode is: "
+ ans2);
}
}
|
Output:
Square root of 226with HALF_EVEN rounding mode is: 15
Square root of 154with FLOOR rounding mode is: 12
Example 2:
import java.math.*;
import com.google.common.math.BigIntegerMath;
class GFG {
public static void main(String args[])
{
try {
BigInteger x1 = BigInteger.valueOf(- 65 );
BigInteger ans1 = BigIntegerMath
.sqrt(x1,
RoundingMode.HALF_EVEN);
}
catch (Exception e) {
System.out.println( "Exception: " + e);
}
}
}
|
Output:
Exception: java.lang.IllegalArgumentException: x (-65) must be >= 0
Reference: https://google.github.io/guava/releases/21.0/api/docs/com/google/common/math/BigIntegerMath.html#sqrt-java.math.BigInteger-java.math.RoundingMode-
Last Updated :
03 Aug, 2021
Like Article
Save Article
Share your thoughts in the comments
Please Login to comment...