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

列印頁面