Java番石榴 | IntMath 的 log2(int x, RoundingMode mode) 方法

Guava 的 IntMath 的log2(int x, RoundingMode mode)方法接受两个参数，根据第二个参数指定的舍入模式计算第一个参数的以 2 为底的对数值。

句法 ：

public static int log2(int x, RoundingMode mode)

参数：该方法有 2 个参数，其中x是整数， mode是指定的舍入模式。

返回值：此方法返回 x 的 Base-2 对数，根据指定的舍入方式进行舍入。

例外：

• IllegalArgumentException：如果 x <= 0。
• ArithmeticException :如果 mode 是 RoundingMode.UNNECESSARY 并且 x 不是 2 的幂。

枚举舍入模式

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.

下面的例子说明了 Guava IntMath 的 log2() 方法的实现：

示例 1：

// Java code to show implementation of
// log2(int x, RoundingMode mode) method
// of Guava's IntMath class
import java.math.RoundingMode;
import com.google.common.math.IntMath;
  
class GFG {
  
    // Driver code
    public static void main(String args[])
    {
        int a1 = 1542;
  
        // Using log2(int x, RoundingMode mode)
        // method of Guava's IntMath class
        // The RoundingMode HALF_EVEN rounds towards
        // the "nearest neighbor" unless both neighbors
        // are equidistant, in which case, round towards
        // the even neighbor.
        System.out.println(IntMath.log2(a1, RoundingMode.HALF_EVEN));
  
        int a2 = 451;
  
        // Using log2(int x, RoundingMode mode)
        // method of Guava's IntMath class
        // The RoundingMode HALF_DOWN rounds towards
        // "nearest neighbor" unless both neighbors
        // are equidistant, in which case round down.
        System.out.println(IntMath.log2(a2, RoundingMode.HALF_DOWN));
    }
}

输出：

11
9

示例 2：

// Java code to show implementation of
// log2(int x, RoundingMode mode) method
// of Guava's IntMath class
import java.math.RoundingMode;
import com.google.common.math.IntMath;
  
class GFG {
  
    static int findlog2(int x, RoundingMode mode)
    {
        try {
            // Using log2(int x, RoundingMode mode)
            // method of Guava's IntMath class
            // The RoundingMode HALF_EVEN rounds towards
            // the "nearest neighbor" unless both neighbors
            // are equidistant, in which case, round towards
            // the even neighbor.
            // This should throw "IllegalArgumentException"
            // as x <= 0
            int ans = IntMath.log2(x, mode);
  
            // Return the answer
            return ans;
        }
        catch (Exception e) {
            System.out.println(e);
            return -1;
        }
    }
  
    // Driver code
    public static void main(String args[])
    {
        int x = -152;
  
        try {
  
            // Function calling
            findlog2(x, RoundingMode.HALF_EVEN);
        }
        catch (Exception e) {
            System.out.println(e);
        }
    }
}

输出：

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

参考 ：
https://google.github.io/guava/releases/20.0/api/docs/com/google/common/math/IntMath.html#log2-int-java.math.RoundingMode-