Java java.math 类 BigInteger（JDK5）

所有类

概述  软件包   类  使用  树  已过时  索引  帮助
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

java.math
类 BigInteger

java.lang.Object
  java.lang.Number
      java.math.BigInteger

所有已实现的接口：

Serializable, Comparable<BigInteger>

---

public class BigInteger
   
   
   
   
   
extends Number
   
   
   
   
   
   
   
   
   
   
implements Comparable<BigInteger>
   
   
   
   
   

不可变的任意精度的整数。所有操作中，都以二进制补码形式表示 BigInteger（如 Java 的基本整数类型）。BigInteger 提供所有 Java 的基本整数操作符的对应物，并提供 java.lang.Math 的所有相关方法。另外，BigInteger 还提供以下运算：模算术、GCD 计算、质数测试、素数生成、位操作以及一些其他操作。

算术运算的语义完全模仿 Java 整数算术运算符的语义，如 The Java Language Specification 中所定义的。例如，以零作为除数的除法抛出 ArithmeticException，而负数除以正数的除法则产生一个负（或零）的余数。Spec 中关于溢出的细节都被忽略了，因为 BigIntegers 所设置的实际大小能适应操作结果的需要。

位移操作的语义扩展了 Java 的位移操作符的语义以允许产生负位移距离。带有负位移距离的右移操作会导致左移操作，反之亦然。忽略无符号的右位移运算符（>>>），因为该操作与由此类提供的“无穷大的词大小”抽象结合使用时毫无意义。

逐位逻辑运算的语义完全模仿 Java 的逐位整数运算符的语义。在执行操作之前，二进制运算符（and、or、xor）对两个操作数中的较短操作数隐式执行符号扩展。

比较操作执行有符号的整数比较，类似于 Java 的关系运算符和相等性运算符执行的比较。

提供的模算术操作用来计算余数、求幂和乘法可逆元。这些方法始终返回非负结果，范围在 0 和 (modulus - 1)（包括）之间。

位操作对其操作数的二进制补码表示形式的单个位进行操作。如有必要，操作数会通过扩展符号来包含指定的位。单一位操作不能产生与正在被操作的 BigInteger 符号不同的 BigInteger，因为它们仅仅影响单个位，并且此类提供的“无穷大词大小”抽象可保证在每个 BigInteger 前存在无穷多的“虚拟符号位”数。

为了简洁明了，在整个 BigInteger 方法的描述中都使用了伪代码。伪代码表达式 (i + j) 是“其值为 BigInteger i 加 BigInteger j 的 BigInteger”的简写。伪代码表达式 (i == j) 是“当且仅当 BigInteger i 表示与 BigInteger j 相同的值时，才为 true”的简写。可以类似地解释其他伪代码表达式。

当为任何输入参数传递 null 对象引用时，此类中的所有方法和构造方法都将抛出 NullPointerException。

从以下版本开始：

JDK1.1

另请参见：

BigDecimal, 序列化表格

---

字段摘要
static BigInteger	ONE           BigInteger 的常量 1。
static BigInteger	TEN           BigInteger 的常量 10。
static BigInteger	ZERO           BigInteger 的常量 0。

 

构造方法摘要
BigInteger(byte[] val)           将包含 BigInteger 的二进制补码表示形式的字节数组转换为 BigInteger。
BigInteger(int signum, byte[] magnitude)           将 BigInteger 的符号-数量表示形式转换为 BigInteger。
BigInteger(int bitLength, int certainty, Random rnd)           构造一个随机生成的正 BigInteger，它可能是一个具有指定 bitLength 的素数。
BigInteger(int numBits, Random rnd)           构造一个随机生成的 BigInteger，它是在 0 到 (2numBits - 1)（包括）范围内均匀分布的值。
BigInteger(String val)           将 BigInteger 的十进制字符串表示形式转换为 BigInteger。
BigInteger(String val, int radix)           将指定基数的 BigInteger 的字符串表示形式转换为 BigInteger。

 

方法摘要
BigInteger	abs()           返回其值是此 BigInteger 的绝对值的 BigInteger。
BigInteger	add(BigInteger val)           返回其值为 (this + val) 的 BigInteger。
BigInteger	and(BigInteger val)           返回其值为 (this & val) 的 BigInteger。
BigInteger	andNot(BigInteger val)           返回其值为 (this & ~val) 的 BigInteger。
int	bitCount()           返回此 BigInteger 的二进制补码表示形式中与符号不同的位的数量。
int	bitLength()           返回此 BigInteger 的最小的二进制补码表示形式的位数，不包括 符号位。
BigInteger	clearBit(int n)           返回其值与清除了指定位的此 BigInteger 等效的 BigInteger。
int	compareTo(BigInteger val)           将此 BigInteger 与指定的 BigInteger 进行比较。
BigInteger	divide(BigInteger val)           返回其值为 (this / val) 的 BigInteger。
BigInteger[]	divideAndRemainder(BigInteger val)           返回包含 (this / val) 后跟 (this % val) 的两个 BigInteger 的数组。
double	doubleValue()           将此 BigInteger 转换为 double。
boolean	equals(Object x)           比较此 BigInteger 与指定的 Object 的相等性。
BigInteger	flipBit(int n)           返回其值与对此 BigInteger 进行指定位翻转后的值等效的 BigInteger。
float	floatValue()           将此 BigInteger 转换为 float。
BigInteger	gcd(BigInteger val)           返回一个 BigInteger，其值是 abs(this) 和 abs(val) 的最大公约数。
int	getLowestSetBit()           返回此 BigInteger 最右端（最低位）1 比特的索引（即从此字节的右端开始到本字节中最右端 1 比特之间的 0 比特的位数）。
int	hashCode()           返回此 BigInteger 的哈希码。
int	intValue()           将此 BigInteger 转换为 int。
boolean	isProbablePrime(int certainty)           如果此 BigInteger 可能为素数，则返回 true，如果它一定为合数，则返回 false。
long	longValue()           将此 BigInteger 转换为 long。
BigInteger	max(BigInteger val)           返回此 BigInteger 和 val 的最大值。
BigInteger	min(BigInteger val)           返回此 BigInteger 和 val 的最小值。
BigInteger	mod(BigInteger m)           返回其值为 (this mod m) 的 BigInteger。
BigInteger	modInverse(BigInteger m)           返回其值为 (this-1 mod m) 的 BigInteger。
BigInteger	modPow(BigInteger exponent, BigInteger m)           返回其值为 (thisexponent mod m) 的 BigInteger。
BigInteger	multiply(BigInteger val)           返回其值为 (this * val) 的 BigInteger。
BigInteger	negate()           返回其值是 (-this) 的 BigInteger。
BigInteger	nextProbablePrime()           返回大于此 BigInteger 的可能为素数的第一个整数。
BigInteger	not()           返回其值为 (~this) 的 BigInteger。
BigInteger	or(BigInteger val)           返回其值为 (this | val) 的 BigInteger。
BigInteger	pow(int exponent)           返回其值为 (thisexponent) 的 BigInteger。
static BigInteger	probablePrime(int bitLength, Random rnd)           返回有可能是素数的、具有指定长度的正 BigInteger。
BigInteger	remainder(BigInteger val)           返回其值为 (this % val) 的 BigInteger。
BigInteger	setBit(int n)           返回其值与设置了指定位的此 BigInteger 等效的 BigInteger。
BigInteger	shiftLeft(int n)           返回其值为 (this << n) 的 BigInteger。
BigInteger	shiftRight(int n)           返回其值为 (this >> n) 的 BigInteger。
int	signum()           返回此 BigInteger 的正负号函数。
BigInteger	subtract(BigInteger val)           返回其值为 (this - val) 的 BigInteger。
boolean	testBit(int n)           当且仅当设置了指定的位时，返回 true。
byte[]	toByteArray()           返回一个字节数组，该数组包含此 BigInteger 的二进制补码表示形式。
String	toString()           返回此 BigInteger 的十进制字符串表示形式。
String	toString(int radix)           返回此 BigInteger 的给定基数的字符串表示形式。
static BigInteger	valueOf(long val)           返回其值等于指定 long 的值的 BigInteger。
BigInteger	xor(BigInteger val)           返回其值为 (this ^ val) 的 BigInteger。

 

从类 java.lang.Number 继承的方法
byteValue, shortValue

 

从类 java.lang.Object 继承的方法
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

 

字段详细信息

ZERO

public static final BigInteger ZERO

BigInteger 的常量 0。

从以下版本开始：

1.2

---

ONE

public static final BigInteger ONE

BigInteger 的常量 1。

从以下版本开始：

1.2

---

TEN

public static final BigInteger TEN

BigInteger 的常量 10。

从以下版本开始：

1.5

构造方法详细信息

BigInteger

public BigInteger(byte[] val)

将包含 BigInteger 的二进制补码表示形式的字节数组转换为 BigInteger。输入数组假定为 big-endian 字节顺序：最高有效字节在第零个元素中。

参数：

val - BigInteger 的 big-endian 二进制补码表示形式。

抛出：

NumberFormatException - val 为零字节长。

---

BigInteger

public BigInteger(int signum,
                  byte[] magnitude)

将 BigInteger 的符号-数量表示形式转换为 BigInteger。该符号表示为一个正负号整数值：-1 表示负，0 表示零，1 表示正。该大小是一个 big-endian 字节顺序的字节数组：最高有效字节在第零个元素中。允许零长度数量数组，这会导致 BigInteger 的值为 0，无论其正负号是 -1、0 还是 1。

参数：

signum - 该数的正负号（-1 表示负，0 表示零，1 表示正）。

magnitude - 该数的大小的 big-endian 二进制表示形式。

抛出：

NumberFormatException - signum 不是三个合法值之一（-1、0 和 1），或者 signum 是 0 并且 magnitude 包含一个或多个非零字节。

---

BigInteger

public BigInteger(String val,
                  int radix)

将指定基数的 BigInteger 的字符串表示形式转换为 BigInteger。该字符串表示形式包括一个可选的减号，后跟一个或多个指定基数的数字。字符到数字的映射由 Character.digit 提供。该字符串不能包含任何其他字符（例如，空格）。

参数：

val - BigInteger 的字符串表示形式。

radix - 要在解释 val 时使用的基数。

抛出：

NumberFormatException - val 不是指定基数的 BigInteger 的有效表示形式，或者 radix 超出从 Character.MIN_RADIX 到 Character.MAX_RADIX（包括）的范围。

另请参见：

Character.digit(char, int)

---

BigInteger

public BigInteger(String val)

将 BigInteger 的十进制字符串表示形式转换为 BigInteger。该字符串表示形式包括一个可选的减号，后跟一个或多个十进制数字序列。字符到数字的映射由 Character.digit 提供。该字符串不能包含任何其他字符（例如，空格）。

参数：

val - BigInteger 的十进制字符串表示形式。

抛出：

NumberFormatException - val 不是 BigInteger 的有效表示形式。

另请参见：

Character.digit(char, int)

---

BigInteger

public BigInteger(int numBits,
                  Random rnd)

构造一个随机生成的 BigInteger，它是在 0 到 (2^numBits - 1)（包括）范围内均匀分布的值。该分布的均匀性假定 rnd 中提供了一个随机位的公平源 (fair source)。注意，此构造方法始终构造一个非负 BigInteger。

参数：

numBits - 新 BigInteger 的最大 bitLength。

rnd - 计算新 BigInteger 时使用的随机源。

抛出：

IllegalArgumentException - 如果 numBits 为负。

另请参见：

bitLength