BigInteger (Java Platform SE 8)

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

すべての実装されたインタフェース:

Serializable, Comparable<BigInteger>
```
public class BigInteger
extends Number
implements Comparable<BigInteger>
```
変更が不可能な、任意精度の整数です。すべての演算は、BigIntegerが(Javaのプリミティブ整数型のような) 2値補数表記法で表されたかのように動作します。BigIntegerは、Javaのすべてのプリミティブ整数演算子と、java.lang.Mathの関連するすべてのメソッドに同等のものを提供します。また、BigIntegerは、モジュラ算術、GCD計算、素数度テスト、素数生成、ビット操作、その他のいくつかの操作に対する演算も提供します。
算術演算のセマンティックスは、『Java言語仕様』に定義されているようにJavaの整数算術演算子を正確に模倣します。たとえば、ゼロ除算はArithmeticExceptionをスローし、正の数による負の数の除算は負(または0)の剰余を出します。オーバーフローに関する仕様内の詳細はすべて無視され、BigIntegerは演算の結果の受け入れに必要なだけ大きくなります。
シフト演算のセマンティックスは、負のシフト移動量を可能にするためJavaのシフト演算子を拡張しています。負のシフト移動量を持つ右シフトは左シフトとなります。逆の場合も同じです。符号なしの右シフト演算子(>>>)は、この演算ではこのクラスが提供する「無限のワード・サイズ」抽出と組み合わせる意味がほとんどないため省かれています。
ビット単位の論理演算のセマンティックスは、Javaのビット整数演算子のセマンティックスを正確に模倣しています。2項演算子(and、or、xor)は、演算前に2つのオペランドの短い方に対して暗黙的に符号拡張を行います。
比較演算は符号付き整数の比較を行います。これは、Javaの関連する演算子および同等の演算子により行われるものと同じです。
モジュラ算術演算は、剰余計算、べき乗、および乗法逆数計算のために提供されています。これらのメソッドは、常に0と(modulus - 1)の間の負でない結果を返します。
ビット演算は、オペランドの2の補数表現のシングル・ビットに使用します。必要に応じて、オペランドの符号は指示するビットを持つように拡張されます。演算中のBigIntegerと異なる符号を持つBigIntegerを生成するシングル・ビット演算はありません。これは、シングル・ビット演算が単一のビットにだけ影響し、このクラスが提供する「無限のワード・サイズ」抽出によって、各BigIntegerに先行する無限の「仮想符号ビット」が存在するためです。
説明をわかりやすく簡潔にするために、BigIntegerメソッドの説明では全体を通して擬似コードを使用します。擬似コード式(i+j)は、「値がBigInteger iの値とBigInteger jの値の和であるBigInteger」を示します。擬似コード式(i == j)は、「BigInteger iがBigInteger jと同じ値を表す場合にだけtrueであること」を示します。ほかの擬似コード式も同じように解釈されます。
このクラスのメソッドおよびコンストラクタはすべて、入力パラメータに対してnullオブジェクト参照が渡されるとNullPointerExceptionをスローします。BigIntegerは、-2^{Integer.MAX_VALUE} (これを含まない)から+2^{Integer.MAX_VALUE} (これを含まない)までの範囲の値をサポートする必要があり、この範囲外の値をサポートすることもできます。確率的素数の値の範囲は限られ、BigIntegerでサポートされる正の範囲全体より小さい場合があります。範囲は少なくとも1から2^500000000でなければなりません。

実装上の注意:

BigIntegerのコンストラクタおよび操作では、結果が-2^{Integer.MAX_VALUE} (これを含まない)から+2^{Integer.MAX_VALUE} (これを含まない)までのサポートされる範囲から外れる場合、ArithmeticExceptionがスローされます。

導入されたバージョン:

JDK1.1

関連項目:

BigDecimal、直列化された形式

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static BigInteger`	`ONE` BigInteger定数1です。
`static BigInteger`	`TEN` BigInteger定数10です。
`static BigInteger`	`ZERO` BigInteger定数0です。

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`BigInteger(byte[] val)` BigIntegerの2の補数2進表現を含むバイト配列をBigIntegerに変換します。
`BigInteger(int signum, byte[] magnitude)` BigIntegerの符号絶対値表現をBigIntegerに変換します。
`BigInteger(int bitLength, int certainty, Random rnd)` ランダムに生成された(おそらく素数である)正のBigIntegerを、指定したビット長で構築します。
`BigInteger(int numBits, Random rnd)` 0 - (2^numBits - 1)の範囲に一様に分散されている、ランダムに生成されたBigIntegerを構築します。
`BigInteger(String val)` BigIntegerの10進String表現をBigIntegerに変換します。
`BigInteger(String val, int radix)` 指定された基数内のBigIntegerのString表現をBigIntegerに変換します。

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`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の2の補数表現内の、符号ビットと異なるビットの数を返します。
`int`	`bitLength()` このBigIntegerの最小の2の補数表現内のビット数を返します。ただし、符号ビットを除きます。
`byte`	`byteValueExact()` この`BigInteger`を`byte`に変換し、失われた情報がないかどうかを確認します。
`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)`と続く、2つの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)` 値が`abs(this)`と`abs(val)`の最大公約数であるBigIntegerを返します。
`int`	`getLowestSetBit()` このBigIntegerのもっとも右側(1番低い位)の1ビットのインデックス(もっとも右側の1ビットの右方向の0ビットの数)を返します。
`int`	`hashCode()` このBigIntegerのハッシュ・コードを返します。
`int`	`intValue()` このBigIntegerを`int`に変換します。
`int`	`intValueExact()` この`BigInteger`を`int`に変換し、失われた情報がないかどうかを確認します。
`boolean`	`isProbablePrime(int certainty)` このBigIntegerが素数である可能性が高い場合は`true`、必ず合成数である場合は`false`を返します。
`long`	`longValue()` このBigIntegerを`long`に変換します。
`long`	`longValueExact()` この`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)` 値が`(this^exponent 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)` 値が`(this^exponent)`の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を返します。
`short`	`shortValueExact()` この`BigInteger`を`short`に変換して、失われた情報がないかどうかを確認します。
`int`	`signum()` このBigIntegerの符号要素を返します。
`BigInteger`	`subtract(BigInteger val)` 値が`(this - val)`であるBigIntegerを返します。
`boolean`	`testBit(int n)` 指定されたビットが設定されている場合にだけ`true`を返します。
`byte[]`	`toByteArray()` このBigIntegerの2の補数表現を含むバイト配列を返します。
`String`	`toString()` このBigIntegerの10進String表現を返します。
`String`	`toString(int radix)` 指定された基数内のこのBigIntegerのString表現を返します。
`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の2の補数2進表現を含むバイト配列をBigIntegerに変換します。入力配列はビッグ・エンディアンのバイト順序(最上位バイトが「0」番目の要素)と見なされます。
    
    パラメータ:
    
    val - BigIntegerの、ビッグ・エンディアン2の補数バイナリ表現。
    
    例外:
    
    NumberFormatException - valの長さが0バイトの場合。
  - BigInteger
```
public BigInteger(int signum,
                  byte[] magnitude)
```
    BigIntegerの符号絶対値表現をBigIntegerに変換します。符号は整数の符号値(負は -1、ゼロは0、正は1)として表されます。絶対値はビッグ・エンディアンのバイト順序のバイト配列(最上位バイトが「0」番目の要素)です。長さが0の絶対値配列は許容され、符号が -1、0、または1のどれであるかにかかわりなくBigInteger値0となります。
    
    パラメータ:
    
    signum - 数字の符号(負は -1、ゼロは0、正は1)。
    
    magnitude - 数字の絶対値のビッグエンディアン・バイナリ表現。
    
    例外:
    
    NumberFormatException - signumが3つの有効な値(-1、0、1)のどれでもないか、signumが0で、magnitudeに1つ以上の0以外のバイトが含まれている場合。
  - BigInteger
```
public BigInteger(String val,
                  int radix)
```
    指定された基数内のBigIntegerのString表現をBigIntegerに変換します。String表現は、指定された基数内の任意のマイナス符号またはプラス記号と、それに続く1つ以上の数字の列で構成されます。文字型から数値型へのマッピングはCharacter.digitで提供されています。Stringには、不適切な文字(空白など)を含めることはできません。
    
    パラメータ:
    
    val - BigIntegerのString表現。
    
    radix - valの解釈で使用される基数。
    
    例外:
    
    NumberFormatException - valが、指定した基数内のBigIntegerの有効な表現ではないか、radixがCharacter.MIN_RADIXからCharacter.MAX_RADIXの範囲外にある場合。
    
    関連項目:
    
    Character.digit(char, int)
  - BigInteger
```
public BigInteger(String val)
```
    BigIntegerの10進String表現をBigIntegerに変換します。String表現は、任意のマイナス符号とそれに続く1つ以上の10進数字の列で構成されます。文字型から数値型へのマッピングはCharacter.digitで提供されています。Stringには、不適切な文字(空白など)を含めることはできません。
    
    パラメータ:
    
    val - BigIntegerの10進数のString表現。
    
    例外:
    
    NumberFormatException - valはBigIntegerの表現としては無効である。
    
    関連項目:
    
    Character.digit(char, int)
  - BigInteger
```
public BigInteger(int numBits,
                  Random rnd)
```
    0 - (2^numBits - 1)の範囲に一様に分散されている、ランダムに生成されたBigIntegerを構築します。分散の一様さは、rndのランダム・ビットのソースに誤りがないことを前提とします。このコンストラクタは、常に負でないBigIntegerを構築します。
    
    パラメータ:
    
    numBits - 新しいBigIntegerの最大ビット長。
    
    rnd - 新しいBigIntegerの計算で使用されるランダム・ビットのソース。
    
    例外:
    
    IllegalArgumentException - numBitsが負の場合。
    
    関連項目:
    
    bitLength()
  - BigInteger
```
public BigInteger(int bitLength,
                  int certainty,
                  Random rnd)
```
    ランダムに生成された(おそらく素数である)正のBigIntegerを、指定したビット長で構築します。
    確実性を指定する必要がない場合は、このコンストラクタではなくprobablePrimeメソッドを使用することをお薦めします。
    
    パラメータ:
    
    bitLength - 返されるBigIntegerのビット長。
    
    certainty - 呼出し側が許容できる不確実性の程度。新しいBigIntegerが素数である確率は、(1 - 1/2^certainty)より大きい。このコンストラクタの実行時間はこのパラメータの値に比例する
    
    rnd - 素数度をテストする候補の選択で使用されるランダム・ビットのソース。
    
    例外:
    
    ArithmeticException - bitLength < 2であるか、bitLengthが大きすぎる場合。
    
    関連項目:
    
    bitLength()
- メソッドの詳細
  - probablePrime
```
public static BigInteger probablePrime(int bitLength,
                                       Random rnd)
```
    指定されたビット長で正のBigInteger (おそらく素数)を返します。このメソッドから返されるBigIntegerが合成数である確率は2^-100を超えません。
    
    パラメータ:
    
    bitLength - 返されるBigIntegerのビット長。
    
    rnd - 素数度をテストする候補の選択で使用されるランダム・ビットのソース。
    
    戻り値:
    
    bitLengthビットのBigInteger (おそらく素数)
    
    例外:
    
    ArithmeticException - bitLength < 2であるか、bitLengthが大きすぎる場合。
    
    導入されたバージョン:
    
    1.4
    
    関連項目:
    
    bitLength()
  - nextProbablePrime
```
public BigInteger nextProbablePrime()
```
    このBigIntegerより大きい最初の整数(おそらく素数)を返します。このメソッドの返す数が合成数である確率は2^-100を超えません。このメソッドは検索時に素数をスキップしません。pを返す場合、this < q < pが成り立つような素数qはありません。
    
    戻り値:
    
    このBigIntegerより大きい最初の整数(おそらく素数)。
    
    例外:
    
    ArithmeticException - this < 0であるか、thisが大きすぎる場合。
    
    導入されたバージョン:
    
    1.5
  - valueOf
```
public static BigInteger valueOf(long val)
```
    値が指定されたlongの値と等しいBigIntegerを返します。この「staticファクトリ・メソッド」は、よく使われるBigIntegerを再利用できるようにするために、(long)コンストラクタの代わりに提供されます。
    
    パラメータ:
    
    val - 返されるBigIntegerの値。
    
    戻り値:
    
    指定値を使ったBigInteger
  - add
```
public BigInteger add(BigInteger val)
```
    値が(this+val)であるBigIntegerを返します。
    
    パラメータ:
    
    val - このBigIntegerに加算する値。
    
    戻り値:
    
    this + val
  - subtract
```
public BigInteger subtract(BigInteger val)
```
    値が(this - val)であるBigIntegerを返します。
    
    パラメータ:
    
    val - このBigIntegerから減算する値。
    
    戻り値:
    
    this - val
  - multiply
```
public BigInteger multiply(BigInteger val)
```
    値が(this * val)であるBigIntegerを返します。
    
    パラメータ:
    
    val - このBigIntegerで乗算する値。
    
    戻り値:
    
    this * val
  - divide
```
public BigInteger divide(BigInteger val)
```
    値が(this /val)であるBigIntegerを返します。
    
    パラメータ:
    
    val - このBigIntegerを除算する値。
    
    戻り値:
    
    this / val
    
    例外:
    
    ArithmeticException - valが0の場合。
  - divideAndRemainder
```
public BigInteger[] divideAndRemainder(BigInteger val)
```
    (this /val)そして(this % val)と続く、2つのBigIntegerの配列を返します。
    
    パラメータ:
    
    val - このBigIntegerを除算する値、および計算された剰余。
    
    戻り値:
    
    2つのBigIntegerの配列。商(this /val)が最初の要素で、剰余(this % val)が最後の要素。
    
    例外:
    
    ArithmeticException - valが0の場合。
  - remainder
```
public BigInteger remainder(BigInteger val)
```
    値が(this % val)であるBigIntegerを返します。
    
    パラメータ:
    
    val - このBigIntegerを除算する値、および計算された剰余。
    
    戻り値:
    
    this % val
    
    例外:
    
    ArithmeticException - valが0の場合。
  - pow
```
public BigInteger pow(int exponent)
```
    値が(this^exponent)のBigIntegerを返します。exponentはBigIntegerではなく整数です。
    
    パラメータ:
    
    exponent - このBigIntegerを累乗する指数。
    
    戻り値:
    
    this^exponent
    
    例外:
    
    ArithmeticException - exponentが負の場合。(非整数値を生成する演算が生じる。)
  - gcd
```
public BigInteger gcd(BigInteger val)
```
    値がabs(this)とabs(val)の最大公約数であるBigIntegerを返します。this == 0 && val == 0の場合は0を返します。
    
    パラメータ:
    
    val - GCDの計算に使用する値。
    
    戻り値:
    
    GCD(abs(this), abs(val))
  - abs
```
public BigInteger abs()
```
    値がこのBigIntegerの絶対値であるBigIntegerを返します。
    
    戻り値:
    
    abs(this)
  - negate
```
public BigInteger negate()
```
    値が(-this)であるBigIntegerを返します。
    
    戻り値:
    
    -this
  - signum
```
public int signum()
```
    このBigIntegerの符号要素を返します。
    
    戻り値:
    
    このBigIntegerが負の場合は -1、ゼロの場合は0、正の場合は1
  - mod
```
public BigInteger mod(BigInteger m)
```
    値が(this mod m)であるBigIntegerを返します。このメソッドは、常に負でない BigIntegerを返すremainderとは異なります。
    
    パラメータ:
    
    m - モジュラス。
    
    戻り値:
    
    this mod m
    
    例外:
    
    ArithmeticException - m ≤ 0
    
    関連項目:
    
    remainder(java.math.BigInteger)
  - modPow
```
public BigInteger modPow(BigInteger exponent,
                         BigInteger m)
```
    値が(this^exponent mod m)のBigIntegerを返します。(powと違って、このメソッドは負の指数を許容する。)
    
    パラメータ:
    
    exponent - 指数
    
    m - モジュラス。
    
    戻り値:
    
    this^exponent mod m
    
    例外:
    
    ArithmeticException - m≤0であるか、指数が負でこのBigIntegerがmの素数ではない場合。
    
    関連項目:
    
    modInverse(java.math.BigInteger)
  - modInverse
```
public BigInteger modInverse(BigInteger m)
```
    値が(this^-1 mod m)であるBigIntegerを返します。
    
    パラメータ:
    
    m - モジュラス。
    
    戻り値:
    
    this^-1 mod m。
    
    例外:
    
    ArithmeticException - m≤0であるか、あるいはこのBigIntegerがmod mの乗法逆数を持たない場合(つまり、このBigIntegerがmの素数ではない場合)。
  - shiftLeft
```
public BigInteger shiftLeft(int n)
```
    値が(this << n)であるBigIntegerを返します。シフト移動量nが負の場合は、このメソッドは右シフトを実行します。(floor(this * 2ⁿ)を計算する。)
    
    パラメータ:
    
    n - ビット単位でのシフト移動量。
    
    戻り値:
    
    this << n
    
    関連項目:
    
    shiftRight(int)
  - shiftRight
```
public BigInteger shiftRight(int n)
```
    値が(this>> n)であるBigIntegerを返します。符号拡張が行われます。シフト移動量nが負の場合は、このメソッドは左シフトを実行します。(floor(this /2ⁿ)を計算する。)
    
    パラメータ:
    
    n - ビット単位でのシフト移動量。
    
    戻り値:
    
    this >> n
    
    関連項目:
    
    shiftLeft(int)
  - and
```
public BigInteger and(BigInteger val)
```
    値が(this & val)であるBigIntegerを返します。(このメソッドは、thisとvalの両方が負の場合は負のBigIntegerを返す。)
    
    パラメータ:
    
    val - このBigIntegerとの論理積をとる値。
    
    戻り値:
    
    this & val
  - or
```
public BigInteger or(BigInteger val)
```
    値が(this|val)であるBigIntegerを返します。(このメソッドは、thisまたはvalが負の場合は負のBigIntegerを返す。)
    
    パラメータ:
    
    val - このBigIntegerとの論理和をとる値。
    
    戻り値:
    
    this | val
  - xor
```
public BigInteger xor(BigInteger val)
```
    値が(this^val)であるBigIntegerを返します。(このメソッドは、thisとvalの片方だけが負の場合に負のBigIntegerを返す。)
    
    パラメータ:
    
    val - このBigIntegerとの排他的論理和をとる値。
    
    戻り値:
    
    this ^ val
  - not
```
public BigInteger not()
```
    値が(~this)であるBigIntegerを返します。(このメソッドは、このBigIntegerが負でない場合に負の値を返す。)
    
    戻り値:
    
    ~this
  - andNot
```
public BigInteger andNot(BigInteger val)
```
    値が(this & ~val)であるBigIntegerを返します。and(val.not())と同等のこのメソッドは、マスキング演算の便宜を図るために提供されています。(このメソッドは、thisが負でvalが正の場合に負のBigInteger数値を返す。)
    
    パラメータ:
    
    val - このBigIntegerで補数がとられ、論理積がとられる値。
    
    戻り値:
    
    this & ~val
  - testBit
```
public boolean testBit(int n)
```
    指定されたビットが設定されている場合にだけtrueを返します。(((this & (1<<n))!= 0)を計算する。)
    
    パラメータ:
    
    n - テストするビットのインデックス。
    
    戻り値:
    
    指定されたビットが設定されている場合にだけtrue。
    
    例外:
    
    ArithmeticException - nが負の場合。
  - setBit
```
public BigInteger setBit(int n)
```
    値がこのBigIntegerに等しいBigIntegerを、指定されたビットを設定して返します。((this|(1<<n))を計算する。)
    
    パラメータ:
    
    n - 設定するビットのインデックス。
    
    戻り値:
    
    this | (1<<n)
    
    例外:
    
    ArithmeticException - nが負の場合。
  - clearBit
```
public BigInteger clearBit(int n)
```
    値がこのBigIntegerに等しいBigIntegerを、指定されたビットをクリアして返します。((this & ~(1<<n))を計算する。)
    
    パラメータ:
    
    n - クリアするビットのインデックス。
    
    戻り値:
    
    this & ~(1<<n)
    
    例外:
    
    ArithmeticException - nが負の場合。
  - flipBit
```
public BigInteger flipBit(int n)
```
    値がこのBigIntegerに等しいBigIntegerを、指定されたビットを反転させて返します。((this^(1<<n))を計算する。)
    
    パラメータ:
    
    n - 反転するビットのインデックス。
    
    戻り値:
    
    this ^ (1<<n)
    
    例外:
    
    ArithmeticException - nが負の場合。
  - getLowestSetBit
```
public int getLowestSetBit()
```
    このBigIntegerのもっとも右側(1番低い位)の1ビットのインデックス(もっとも右側の1ビットの右方向の0ビットの数)を返します。このBigIntegerに1ビットが1つも含まれない場合は -1を返します。((this == 0? -1 : log2(this & -this))を計算する。)
    
    戻り値:
    
    このBigIntegerのもっとも右側の1ビットのインデックス。
  - bitLength
```
public int bitLength()
```
    このBigIntegerの最小の2の補数表現内のビット数を返します。ただし、符号ビットを除きます。正のBigIntegerについては、通常の2進表現におけるビットの数に等しくなります。((ceil(log2(this < 0 ? -this : this+1)))を計算する。)
    
    戻り値:
    
    このBigIntegerの最小の2の補数表現内のビット数。ただし、符号ビットを除きます。
  - bitCount
```
public int bitCount()
```
    このBigIntegerの2の補数表現内の、符号ビットと異なるビットの数を返します。このメソッドはBigInteger上にビット・ベクトル形式の設定を実装する場合に便利です。
    
    戻り値:
    
    このBigIntegerの2の補数表現内の、符号ビットと異なるビットの数。
  - isProbablePrime
```
public boolean isProbablePrime(int certainty)
```
    このBigIntegerが素数である可能性が高い場合はtrue、必ず合成数である場合はfalseを返します。certaintyが≤0の場合、trueが返されます。
    
    パラメータ:
    
    certainty - 呼出し側が許容できる不確実性の程度。この呼出しがtrueを返す場合、このBigIntegerが素数である確率は(1 - 1/2^certainty)を超えます。このメソッドの実行時間はこのパラメータの値に比例します。
    
    戻り値:
    
    このBigIntegerが素数である可能性が高い場合はtrue、必ず合成数である場合はfalse。
  - compareTo
```
public int compareTo(BigInteger val)
```
    このBigIntegerを指定されたBigIntegerと比較します。このメソッドは、6つのboolean型の比較演算子(<、==、>、>=、!=、<=)のそれぞれに対する個々のメソッドの代わりに提供されます。これらの比較を行うには(x.compareTo(y) <op> 0)という組合せをお薦めします。この場合、<op>には6つの比較演算子のうちの1つが入ります。
    
    定義:
    
    compareTo、インタフェース: Comparable<BigInteger>
    
    パラメータ:
    
    val - このBigIntegerと比較するBigInteger。
    
    戻り値:
    
    このBigIntegerの数値がvalより小さい場合は -1、等しい場合は0、大きい場合は1。
  - equals
```
public boolean equals(Object x)
```
    このBigIntegerと指定されたObjectが等しいかどうかを比較します。
    
    オーバーライド:
    
    equals、クラス: Object
    
    パラメータ:
    
    x - このBigIntegerと比較するObject。
    
    戻り値:
    
    指定されたObjectが、このBigIntegerと値が等しいBigIntegerである場合にだけtrue。
    
    関連項目:
    
    Object.hashCode(), HashMap
  - min
```
public BigInteger min(BigInteger val)
```
    このBigIntegerとvalの最小値を返します。
    
    パラメータ:
    
    val - 最小値の計算に使用する値。
    
    戻り値:
    
    このBigIntegerとvalのうちで小さい方の値を持つBigInteger。値が等しい場合はどちらかが返される。
  - max
```
public BigInteger max(BigInteger val)
```
    このBigIntegerとvalの最大値を返します。
    
    パラメータ:
    
    val - 最大値の計算に使用する値。
    
    戻り値:
    
    このBigIntegerとvalのうちで大きい方の値を持つBigInteger。値が等しい場合はどちらかが返される。
  - hashCode
```
public int hashCode()
```
    このBigIntegerのハッシュ・コードを返します。
    
    オーバーライド:
    
    hashCode、クラス: Object
    
    戻り値:
    
    このBigIntegerのハッシュ・コード
    
    関連項目:
    
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - toString
```
public String toString(int radix)
```
    指定された基数内のこのBigIntegerのString表現を返します。基数がCharacter.MIN_RADIXからCharacter.MAX_RADIXの範囲外にある場合、デフォルトでは10になります(Integer.toStringの場合と同じ)。Character.forDigitによる数値から文字へのマッピングが使用され、必要に応じてマイナス符号が前に付けられます。(この表現は(String, int)コンストラクタと互換性があります)。
    
    パラメータ:
    
    radix - String表現の基数。
    
    戻り値:
    
    指定された基数内のこのBigIntegerのString表現。
    
    関連項目:
    
    Integer.toString(int, int), Character.forDigit(int, int), BigInteger(java.lang.String, int)
  - toString
```
public String toString()
```
    このBigIntegerの10進String表現を返します。Character.forDigitによる数値から文字へのマッピングが使用され、必要に応じてマイナス符号が前に付けられます。(この表現は(String)コンストラクタと互換性があり、Javaの+演算子との連結を可能にします。)
    
    オーバーライド:
    
    toString、クラス: Object
    
    戻り値:
    
    このBigIntegerの10進数のString表現。
    
    関連項目:
    
    Character.forDigit(int, int), BigInteger(java.lang.String)
  - toByteArray
```
public byte[] toByteArray()
```
    このBigIntegerの2の補数表現を含むバイト配列を返します。バイト配列はビッグエンディアンのバイト順序(最上位バイトが「0」番目の要素)です。配列には、最低1つの符号ビットを含むこのBigIntegerの表現に必要な最小のバイト数((ceil((this.bitLength()+1)/8)))が含まれます(この表現は(byte[])コンストラクタと互換性があります)。
    
    戻り値:
    
    このBigIntegerの2の補数表現を含むバイト配列。
    
    関連項目:
    
    BigInteger(byte[])
  - intValue
```
public int intValue()
```
    このBigIntegerをintに変換します。この変換は、『Java™言語仕様』のセクション5.1.3で定義されたlongからintへのナロー・プリミティブ変換と同様です。このBigIntegerが長すぎてint内に収まらない場合、下位32ビットだけが返されます。この変換により、このBigInteger値の絶対値全体に関する情報が失われ、逆の符号で返される可能性があります。
    
    定義:
    
    intValue、クラス: Number
    
    戻り値:
    
    intに変換されたこのBigInteger。
    
    関連項目:
    
    intValueExact()
  - longValue
```
public long longValue()
```
    このBigIntegerをlongに変換します。この変換は、『Java™言語仕様』のセクション5.1.3で定義されたlongからintへのナロー・プリミティブ変換と同様です。このBigIntegerが長すぎてlong内に収まらない場合、下位64ビットだけが返されます。この変換により、このBigInteger値の絶対値全体に関する情報が失われ、逆の符号で返される可能性があります。
    
    定義:
    
    longValue、クラス: Number
    
    戻り値:
    
    longに変換されたこのBigInteger。
    
    関連項目:
    
    longValueExact()
  - floatValue
```
public float floatValue()
```
    このBigIntegerをfloatに変換します。この変換は、『Java(tm)言語仕様』のセクション5.1.3で定義されたdoubleからfloatへの縮小プリミティブ変換と同様です。このBigIntegerの絶対値が大きすぎてfloatとして表現できない場合、適宜Float.NEGATIVE_INFINITYまたはFloat.POSITIVE_INFINITYに変換されます。戻り値が有限である場合も、この変換により、BigInteger値の精度に関する情報が失われる可能性があります。
    
    定義:
    
    floatValue、クラス: Number
    
    戻り値:
    
    floatに変換されたこのBigInteger。
  - doubleValue
```
public double doubleValue()
```
    このBigIntegerをdoubleに変換します。この変換は、『Java(tm)言語仕様』のセクション5.1.3で定義されたdoubleからfloatへの縮小プリミティブ変換と同様です。このBigIntegerの絶対値が大きすぎてdoubleとして表現できない場合、適宜Double.NEGATIVE_INFINITYまたはDouble.POSITIVE_INFINITYに変換されます。戻り値が有限である場合も、この変換により、BigInteger値の精度に関する情報が失われる可能性があります。
    
    定義:
    
    doubleValue、クラス: Number
    
    戻り値:
    
    doubleに変換されたこのBigInteger。
  - longValueExact
```
public long longValueExact()
```
    このBigIntegerをlongに変換し、失われた情報がないかどうかを確認します。このBigIntegerの値がlong型の範囲から外れている場合は、ArithmeticExceptionがスローされます。
    
    戻り値:
    
    longに変換されたこのBigInteger。
    
    例外:
    
    ArithmeticException - thisの値がlongにぴったり収まらない場合。
    
    導入されたバージョン:
    
    1.8
    
    関連項目:
    
    longValue()
  - intValueExact
```
public int intValueExact()
```
    このBigIntegerをintに変換し、失われた情報がないかどうかを確認します。このBigIntegerの値がint型の範囲から外れている場合は、ArithmeticExceptionがスローされます。
    
    戻り値:
    
    intに変換されたこのBigInteger。
    
    例外:
    
    ArithmeticException - thisの値がintにぴったり収まらない場合。
    
    導入されたバージョン:
    
    1.8
    
    関連項目:
    
    intValue()
  - shortValueExact
```
public short shortValueExact()
```
    このBigIntegerをshortに変換して、失われた情報がないかどうかを確認します。このBigIntegerの値がshort型の範囲から外れている場合は、ArithmeticExceptionがスローされます。
    
    戻り値:
    
    shortに変換されたこのBigInteger。
    
    例外:
    
    ArithmeticException - thisの値がshortにぴったり収まらない場合。
    
    導入されたバージョン:
    
    1.8
    
    関連項目:
    
    Number.shortValue()
  - byteValueExact
```
public byte byteValueExact()
```
    このBigIntegerをbyteに変換し、失われた情報がないかどうかを確認します。このBigIntegerの値がbyte型の範囲から外れている場合は、ArithmeticExceptionがスローされます。
    
    戻り値:
    
    byteに変換されたこのBigInteger。
    
    例外:
    
    ArithmeticException - thisの値がbyteにぴったり収まらない場合。
    
    導入されたバージョン:
    
    1.8
    
    関連項目:
    
    Number.byteValue()

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスBigInteger

フィールドのサマリー

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang. Numberから継承されるメソッド

クラス java.lang.Objectから継承されたメソッド

フィールドの詳細

ZERO

ONE

TEN

コンストラクタの詳細

BigInteger

BigInteger

BigInteger

BigInteger

BigInteger

BigInteger

メソッドの詳細

probablePrime

nextProbablePrime

valueOf

add

subtract

multiply

divide

divideAndRemainder

remainder

pow

gcd

abs

negate

signum

mod

modPow

modInverse

shiftLeft

shiftRight

and

or

xor

not

andNot

testBit

setBit

clearBit

flipBit

getLowestSetBit

bitLength

bitCount

isProbablePrime

compareTo

equals

min

max

hashCode

toString

toString

toByteArray

intValue

longValue

floatValue

doubleValue

longValueExact

intValueExact

shortValueExact

byteValueExact