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:
// Java code to show implementation of // sqrt(BigInteger x, RoundingMode mode) method // of Guava's BigIntegerMath class import java.math.*;
import com.google.common.math.BigIntegerMath;
class GFG {
// Driver code
public static void main(String args[])
{
BigInteger x1 = BigInteger.valueOf( 226 );
// Using sqrt(BigInteger x, RoundingMode mode)
// method of Guava's BigIntegerMath class
// The RoundingMode HALF_EVEN rounds towards
// the nearest neighbor unless both neighbors
// are equidistant, in which case, round towards
// the even neighbor.
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 );
// Using sqrt(BigInteger x, RoundingMode mode)
// method of Guava's BigIntegerMath class
// The RoundingMode FLOOR rounds towards
// negative infinity.
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:
// Java code to show implementation of // sqrt(BigInteger x, RoundingMode mode) method // of Guava's BigIntegerMath class import java.math.*;
import com.google.common.math.BigIntegerMath;
class GFG {
// Driver code
public static void main(String args[])
{
try {
BigInteger x1 = BigInteger.valueOf(- 65 );
// Using sqrt(BigInteger x, RoundingMode mode)
// method of Guava's BigIntegerMath class
// The RoundingMode HALF_EVEN rounds towards
// the nearest neighbor unless both neighbors
// are equidistant, in which case, round towards
// the even neighbor.
BigInteger ans1 = BigIntegerMath
.sqrt(x1,
RoundingMode.HALF_EVEN);
// This should throw "IllegalArgumentException"
// as x1 < 0
}
catch (Exception e) {
System.out.println( "Exception: " + e);
}
}
} |
Output:
Exception: java.lang.IllegalArgumentException: x (-65) must be >= 0