Guava - LongMath 类

LongMath 提供了关于 long 类型的实用方法。

类声明

以下是 com.google.common.math.LongMath 类的声明：

@GwtCompatible(emulated = true)
public final class LongMath
   extends Object

方法

序号	方法及描述
1	static long binomial(int n, int k) 返回 n 选 k 的组合数，也称为 n 和 k 的二项式系数，如果结果不适合 long 类型，则返回 Long.MAX_VALUE。
2	static long checkedAdd(long a, long b) 返回 a 和 b 的和，前提是不溢出。
3	static long checkedMultiply(long a, long b) 返回 a 和 b 的乘积，前提是不溢出。
4	static long checkedPow(long b, int k) 返回 b 的 k 次幂，前提是不溢出。
5	static long checkedSubtract(long a, long b) 返回 a 和 b 的差，前提是不溢出。
6	static long divide(long p, long q, RoundingMode mode) 返回 p 除以 q 的结果，使用指定的 RoundingMode 进行舍入。
7	static long factorial(int n) 返回 n!，即前 n 个正整数的乘积，如果 n == 0，则返回 1，如果结果不适合 long 类型，则返回 Long.MAX_VALUE。
8	static long gcd(long a, long b) 返回 a 和 b 的最大公约数。
9	static boolean isPowerOfTwo(long x) 如果 x 表示 2 的幂，则返回 true。
10	static int log10(long x, RoundingMode mode) 返回 x 的以 10 为底的对数，根据指定的舍入模式进行舍入。
11	static int log2(long x, RoundingMode mode) 返回 x 的以 2 为底的对数，根据指定的舍入模式进行舍入。
12	static long mean(long x, long y) 返回 x 和 y 的算术平均值，向负无穷大舍入。
13	static int mod(long x, int m) 返回 x mod m，一个不大于 m 的非负值。
14	static long mod(long x, long m) 返回 x mod m，一个不大于 m 的非负值。
15	static long pow(long b, int k) 返回 b 的 k 次幂。
16	static long sqrt(long x, RoundingMode mode) 返回 x 的平方根，使用指定的舍入模式进行舍入。

继承的方法

此类继承自以下类的方法：

java.lang.Object

LongMath 类示例

使用您选择的任何编辑器创建以下 Java 程序，例如在 C:/> Guava 目录下。

GuavaTester.java

import java.math.RoundingMode;
import com.google.common.math.LongMath;

public class GuavaTester {

   public static void main(String args[]) {
      GuavaTester tester = new GuavaTester();
      tester.testLongMath();
   }

   private void testLongMath() {
      try {
         System.out.println(LongMath.checkedAdd(Long.MAX_VALUE, Long.MAX_VALUE));
         
      } catch(ArithmeticException e) {
         System.out.println("Error: " + e.getMessage());
      }

      System.out.println(LongMath.divide(100, 5, RoundingMode.UNNECESSARY));
      try {
         //exception will be thrown as 100 is not completely divisible by 3
         // thus rounding is required, and RoundingMode is set as UNNESSARY
         System.out.println(LongMath.divide(100, 3, RoundingMode.UNNECESSARY));
         
      } catch(ArithmeticException e) {
         System.out.println("Error: " + e.getMessage());
      }

      System.out.println("Log2(2): " + LongMath.log2(2, RoundingMode.HALF_EVEN));

      System.out.println("Log10(10): " + LongMath.log10(10, RoundingMode.HALF_EVEN));

      System.out.println("sqrt(100): " + LongMath.sqrt(LongMath.pow(10,2), RoundingMode.HALF_EVEN));

      System.out.println("gcd(100,50): " + LongMath.gcd(100,50));

      System.out.println("modulus(100,50): " + LongMath.mod(100,50));

      System.out.println("factorial(5): " + LongMath.factorial(5));
   }
}

验证结果

使用 javac 编译器编译类，如下所示：

C:\Guava>javac GuavaTester.java

现在运行 GuavaTester 查看结果。

C:\Guava>java GuavaTester

查看结果。

Error: overflow
20
Error: mode was UNNECESSARY, but rounding was necessary
Log2(2): 1
Log10(10): 1
sqrt(100): 10
gcd(100,50): 50
modulus(100,50): 0
factorial(5): 120

guava_math_utilities.htm

打印页面