Función BigIntegerMath floorPowerOfTwo() | guayaba | Java

El método floorPowerOfTwo(BigInteger x) de la clase BigIntegerMath de Guava devuelve la mayor potencia de dos menor o igual que x. Esto es equivalente a BigInteger.valueOf(2).pow(log2(x, FLOOR)).
Sintaxis: 
 

public static BigInteger floorPowerOfTwo(BigInteger x)

Parámetros: Este método toma el BigInteger x como parámetro cuya potencia mínima de dos se encuentra.
Valor devuelto: este método devuelve la mayor potencia de dos menor o igual que x.
Excepciones: este método lanza IllegalArgumentException si x <= 0 .
Los siguientes ejemplos ilustran el método BigIntegerMath.floorPowerOfTwo():
Ejemplo 1:
 

// Java code to show implementation of
// floorPowerOfTwo() 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 n1 = BigInteger.valueOf(10);
 
        // Using floorPowerOfTwo(BigInteger x) method
        // of Guava's BigIntegerMath class
        BigInteger
            ans1
            = BigIntegerMath.floorPowerOfTwo(n1);
 
        System.out.println("Largest power of 2 less "
                           + "than or equal to " + n1
                           + " is: " + ans1);
 
        BigInteger n2 = BigInteger.valueOf(127);
 
        // Using floorPowerOfTwo(BigInteger x) method
        // of Guava's BigIntegerMath class
        BigInteger
            ans2
            = BigIntegerMath.floorPowerOfTwo(n2);
 
        System.out.println("Largest power of 2 less "
                           + "than or equal to " + n2
                           + " is: " + ans2);
    }
}

Producción: 
 

Largest power of 2 less than or equal to 10 is: 8
Largest power of 2 less than or equal to 127 is: 64

Ejemplo 2: Para mostrar IllegalArgumentException
 

// Java code to show implementation of
// floorPowerOfTwo(BigInteger x) 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 n1 = BigInteger.valueOf(-3);
 
            // Using floorPowerOfTwo(BigInteger x) method
            // of Guava's BigIntegerMath class
            // This should raise "IllegalArgumentException"
            // as x <= 0
            BigInteger
                ans1
                = BigIntegerMath.floorPowerOfTwo(n1);
 
            System.out.println("Largest power of 2 less "
                               + "than or equal to " + n1
                               + " is: " + ans1);
        }
        catch (Exception e) {
            System.out.println("Exception: " + e);
        }
    }
}

Producción: 
 

Exception: java.lang.IllegalArgumentException: x (-3) must be > 0

Referencia: https://google.github.io/guava/releases/21.0/api/docs/com/google/common/math/BigIntegerMath.html#floorPowerOfTwo-java.math.BigInteger-