| Methods |
|---|
| public BigInteger |
abs()
返回其值是此 BigInteger 的绝对值的 BigInteger。
|
| public BigInteger |
add(BigInteger val)
返回其值为 (this + val) 的 BigInteger。
| val |
将添加到此 BigInteger 中的值。 |
| return |
this + val |
|
| public BigInteger |
and(BigInteger val)
返回其值为 (this & val) 的 BigInteger。（当且仅当 this 和 val 同时为负时，此方法返回一个负 BigInteger。）
| val |
要与此 BigInteger 执行 AND（与）运算的值。 |
| return |
this & val |
|
| public BigInteger |
andNot(BigInteger val)
返回其值为 (this & ~val) 的 BigInteger。此方法等效于 and(val.not())，提供此方法是为了更方便地进行屏蔽操作。（当且仅当this 为负且 val 为正时，此方法返回一个负 BigInteger。）
| val |
要进行求补且与此 BigInteger 执行与运算的值。 |
| return |
this & ~val |
|
| public int |
bitCount()
返回此 BigInteger 的二进制补码表示形式中与符号不同的位的数量。此方法在实现 BigInteger 上的位向量样式设置时非常有用。
| return |
返回此 BigInteger 的二进制补码表示形式中与符号位不同的位的数量。 |
|
| public int |
bitLength()
返回此 BigInteger 的最小的二进制补码表示形式的位数，不包括 符号位。对于正 BigInteger，这等于常规二进制表示形式中的位数。（计算 (ceil(log2(this < 0 ? -this : this+1)))。)
| return |
返回此 BigInteger 的最小的二进制补码表示形式中的位数，不包括 符号位。 |
|
| public BigInteger |
clearBit(int n)
返回其值与清除了指定位的此 BigInteger 等效的 BigInteger。（计算 (this & ~(1<<n))。）
|
| public int |
compareTo(BigInteger val)
将此 BigInteger 与指定的 BigInteger 进行比较。对于针对六个布尔比较运算符 (<, ==, >, >=, !=, <=) 中的每一个运算符的各个方法，优先提供此方法。执行这些比较的建议语句是：(x.compareTo(y) <op> 0)，其中 <op> 是六个比较运算符之一。
| val |
将此 BigInteger 与之比较的 BigInteger。 |
| return |
当此 BigInteger 在数值上小于、等于或大于 val 时，返回 -1，0，或 1。 |
|
| public BigInteger |
divide(BigInteger val)
返回其值为 (this / val) 的 BigInteger。
| val |
此 BigInteger 要除以的值。 |
| return |
this / val |
| Throws |
ArithmeticException:
ArithmeticException val==0 |
|
| public BigInteger[] |
divideAndRemainder(BigInteger val)
返回包含 (this / val) 后跟 (this % val) 的两个 BigInteger 的数组。
| val |
此 BigInteger 要除以的值和计算所得的余数。 |
| return |
两个 BigInteger 的数组：商 (this / val) 是初始元素，余数 (this % val) 是最终元素。 |
| Throws |
ArithmeticException:
ArithmeticException val==0 |
|
| public double |
doubleValue()
将此 BigInteger 转换为 double。此转换类似于 Java Language Specification 中定义的从 double 到 float 的基本收缩转换：如果此 BigInteger 的数量太大，不能表示为 double，则将其适当地转换为 Double#NEGATIVE_INFINITY 或 Double#POSITIVE_INFINITY。注意，即使在返回值是有限的情况下，此转换也可以丢失关于 BigInteger 值的精度的信息。
| return |
转换为 double 的此 BigInteger。 |
|
| public boolean |
equals(Object x)
比较此 BigInteger 与指定的 Object 的相等性。
| x |
将此 BigInteger 与之比较的 Object。 |
| return |
当且仅当指定的 Object 是一个其值在数字上等于此 BigInteger 的 BigInteger 时，返回 true。 |
|
| public BigInteger |
flipBit(int n)
返回其值与对此 BigInteger 进行指定位翻转后的值等效的 BigInteger。（计算 (this ^ (1<<n))。）
|
| public float |
floatValue()
将此 BigInteger 转换为 float。此转换类似于 Java Language Specification 中定义的从 double 到 float 的基本收缩转换：如果此 BigInteger 的数量太大，不能表示为 float，则将其适当地转换为 Float#NEGATIVE_INFINITY 或 Float#POSITIVE_INFINITY。注意，即使在返回值是有限的情况下，此转换也可以丢失关于 BigInteger 值的精度的信息。
| return |
转换为 float 的此 BigInteger。 |
|
| public BigInteger |
gcd(BigInteger val)
返回一个 BigInteger，其值是 abs(this) 和 abs(val) 的最大公约数。如果 this==0 && val==0，则返回 0 。
| val |
要一起计算最大公约数的值。 |
| return |
GCD(abs(this), abs(val)) |
|
| public int |
hashCode()
返回此 BigInteger 的哈希码。
| return |
此 BigInteger 的哈希码。 |
|
| public int |
intValue()
将此 BigInteger 转换为 int。此转换类似于 Java Language Specification 中定义的从 long 到 int 的基本收缩转换：如果此 BigInteger 太长而不适合用 int 表示，则仅返回 32 位的低位字节。注意，此转换会丢失关于该 BigInteger 值的总大小的信息，并返回带有相反符号的结果。
| return |
转换为 int 的此 BigInteger。 |
|
| public long |
longValue()
将此 BigInteger 转换为 long。此转换类似于 Java Language Specification 中定义的从 long 到 int 的基本收缩转换：如果此 BigInteger 太长而不适合用 long 表示，则仅返回 64 位的低位字节。注意，此转换会丢失关于该 BigInteger 值的总大小的信息，并返回带有相反符号的结果。
| return |
转换为 long 的此 BigInteger。 |
|
| public BigInteger |
max(BigInteger val)
返回此 BigInteger 和 val 的最大值。
| val |
要计算最大值的值。 |
| return |
其值为此 BigInteger 和 val 中较大值的 BigInteger。如果它们相等，可能返回其中之一。 |
|
| public BigInteger |
min(BigInteger val)
返回此 BigInteger 和 val 的最小值。
| val |
要计算最小值的值。 |
| return |
其值为此 BigInteger 和 val 中的较小值的 BigInteger。如果它们相等，可能返回其中之一。 |
|
| public BigInteger |
mod(BigInteger m)
返回其值为 (this mod m) 的 BigInteger。此方法不同于 remainder，因为它始终返回一个 非负 BigInteger。
|
| public BigInteger |
modInverse(BigInteger m)
返回其值为 (this-1 mod m) 的 BigInteger。
| m |
模数。 |
| return |
this-1 mod m. |
| Throws |
ArithmeticException:
m <= 0，或者此 BigInteger 没有乘法可逆元 mod m（即此 BigInteger 不是 m 的相对素数）。 |
|
| public BigInteger |
modPow(BigInteger exponent, BigInteger m)
返回其值为 (thisexponent mod m) 的 BigInteger。（与 pow 不同，此方法允许使用负指数。）
|
| public BigInteger |
multiply(BigInteger val)
返回其值为 (this * val) 的 BigInteger。
| val |
要乘以此 BigInteger 的值。 |
| return |
this * val |
|
| public BigInteger |
negate()
返回其值是 (-this) 的 BigInteger。
|
| public BigInteger |
nextProbablePrime()
返回大于此 BigInteger 的可能为素数的第一个整数。此方法返回的数是合数的概率不超出 2-100。此方法在执行以下搜索时将始终不会跳过素数：如果它返回 p，则不存在 this < q < p 的素数 q。
|
| public BigInteger |
not()
返回其值为 (~this) 的 BigInteger。（当且仅当此 BigInteger 为非负时，此方法返回一个负值。）
|
| public BigInteger |
or(BigInteger val)
返回其值为 (this | val) 的 BigInteger。（当且仅当 this 和 val 之一为负时，此方法返回一个负 BigInteger。）
| val |
要与此 BigInteger 执行或运算的值。 |
| return |
this | val |
|
| public BigInteger |
pow(int exponent)
返回其值为 (thisexponent) 的 BigInteger。注意，exponent 是一个整数而不是 BigInteger。
| exponent |
此 BigInteger 的指数。 |
| return |
thisexponent |
| Throws |
ArithmeticException:
exponent 为负。（这会导致该运算产生一个非整数值。） |
|
| public static BigInteger |
probablePrime(int bitLength, Random rnd)
返回有可能是素数的、具有指定长度的正 BigInteger。此方法返回的 BigInteger 是合数的概率不超出 2-100。
| bitLength |
返回的 BigInteger 的 bitLength。 |
| rnd |
随机比特源，用这些随机比特选择用来进行质数测试的候选数。 |
| return |
可能是素数的 bitLength 个位的 BigInteger |
| Throws |
ArithmeticException:
bitLength < 2。 |
| since |
1.4 |
| See also |
bitLength() |
|
| public BigInteger |
remainder(BigInteger val)
返回其值为 (this % val) 的 BigInteger。
| val |
此 BigInteger 要除以的值和计算所得的余数。 |
| return |
this % val |
| Throws |
ArithmeticException:
ArithmeticException val==0 |
|
| public BigInteger |
shiftLeft(int n)
返回其值为 (this << n) 的 BigInteger。位移距离 n 可以为负，在此情况下，此方法执行右移操作。（计算 floor(this * 2n)。）
| n |
以位为单位的位移距离。 |
| return |
this << n |
| See also |
shiftRight |
|
| public BigInteger |
shiftRight(int n)
返回其值为 (this >> n) 的 BigInteger。执行符号扩展。位移距离 n 可以为负，在此情况下，此方法执行左移操作。（计算floor(this / 2n)。）
| n |
以位为单位的位移距离。 |
| return |
this >> n |
| See also |
shiftLeft |
|
| public int |
signum()
返回此 BigInteger 的正负号函数。
| return |
当此 BigInteger 的值为负、零或正时，返回 -1、0 或 1。 |
|
| public BigInteger |
subtract(BigInteger val)
返回其值为 (this - val) 的 BigInteger。
| val |
从此 BigInteger 中减去的值。 |
| return |
this - val |
|
| public boolean |
testBit(int n)
当且仅当设置了指定的位时，返回 true。（计算 ((this & (1<<n)) != 0)。）
|
| public byte[] |
toByteArray()
返回一个 byte 数组，该数组包含此 BigInteger 的二进制补码表示形式。该 byte 数组将为 big-endian 字节顺序：最高有效字节在第零个元素中。此数组将包含表示此 BigInteger 所需的最小数量的字节，至少包括一个符号位，即 (ceil((this.bitLength() + 1)/8))。（此表示形式与 (byte[]) 构造方法兼容。）
|
| public String |
toString(int radix)
返回此 BigInteger 的给定基数的字符串表示形式。如果该基数超出从 Character#MIN_RADIX 到 Character#MAX_RADIX（包括）这一范围，则其默认值为 10（Integer.toString 就是这种情况）。使用由 Character.forDigit 提供的从数字到字符的映射，并在需要时在前面加一个负号。（此表示形式与 (String, int) 构造方法兼容。）
|
| public String |
toString()
返回此 BigInteger 的十进制字符串表示形式。使用由 Character.forDigit 提供的从数字到字符的映射，并在需要时在前面加一个负号。（此表示形式与 (String) 构造方法兼容，并允许使用 Java 的 + 运算符将字符串连接。）
|
| public static BigInteger |
valueOf(long val)
返回其值等于指定 long 的值的 BigInteger。提供的此“静态工厂方法”优先于 (long) 构造方法，因为前者允许重用经常使用的 BigInteger。
| val |
要返回的 BigInteger 的值。 |
| return |
具有指定值的 BigInteger。 |
|
| public BigInteger |
xor(BigInteger val)
返回其值为 (this ^ val) 的 BigInteger。（当且仅当 this 和 val 中只有一个为负时，此方法返回一个负 BigInteger。）
| val |
要与此 BigInteger 执行异或运算的值。 |
| return |
this ^ val |
|
