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)の剰余を出します。

シフト演算のセマンティックスは、� のシフト移動量を可能にするため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コンストラクタまたはメソッドがサポートされている範囲外の値を生成すると、ArithmeticExceptionがスローされます。確率的� 数の値の範囲は限られ、BigIntegerでサポートされる正の範囲全体より小さい� �合があります。範囲は少なくとも1から2^500000000でなければなりません。

APIのノート:

BigInteger値は任意の精度整数であるため、このクラスのメソッドのアルゴリズ� の複雑さは変化し、入力のサイズが超線形になる可能性があります。たとえば、intValue()のようなメソッドは、inO(1)を実行することが想定されます。これは、現在の内部表現では、intへの変換を実行するために、BigIntegerの固定サイズのコンポーネントのみにアクセスする必要があるため、一定の時間です。対照的に、not()のようなメソッドは、inO(n)時間を実行します。ここで、nはBigIntegerのサイズ(ビット単位)です。つまり、入力のサイズに比例して時間内に実行されます。サイズnの2つのBigInteger値を乗算する� �合、ナイーブ乗算アルゴリズ� がtimeO(n²)で実行され、理論結果は、このカテゴリの表現を使用する数値の乗算アルゴリズ� が「少なくとも」 O(n log n)で実行される必要があることを示します。ナイブ・ケースと理論的ケースの境界間の共通の乗算アルゴリズ� には、Karatsuba multiplication(O(n^1.585)と3ウェイToom-Cook multiplication(O(n^1.465)があります。

multiplyの特定の実装は、異なる入力に対して異なるアルゴリズ� を自由に切り替えることができます。たとえば、より単純なアルゴリズ� が漸近的複雑度が大きい� �合でも、より単純な入力に対してより単純なアルゴリズ� を使用して製品を生成する実際の実行時間を短縮できます。

操作では、中間結果を割り当ててコンピュートすることもできます。これらの割当ては、アルゴリズ� の実行時間に比例して大きくなる可能性があります。

実行時間または操作� �域の境界に関するBigIntegerのユーザーは、選択した大きさを超えるBigInteger値をスクリーニングできます。

実装上のノート:

リファレンス実装では、結果が -2^{Integer.MAX_VALUE} (除外)から+2^{Integer.MAX_VALUE} (除外)までの範囲外である� �合、BigIntegerコンストラクタと操作はArithmeticExceptionをスローします。

Java言語仕様を参照してく� さい:

4.2.2 整数演算

導入されたバージョン:

1.1

関連� �目:

フィールドのサマリー

フィールド

修飾子と型

フィールド

説明

static final BigInteger

ONE

BigInteger定数1です。

static final BigInteger

TEN

BigInteger定数10です。

static final BigInteger

TWO

BigInteger定数2。

static final BigInteger

ZERO

BigInteger定数0です。
コンストラクタのサマリー

コンストラクタ

コンストラクタ

説明

BigInteger(byte[] val)

BigIntegerの2の補数2進表現を含むバイト配列をBigIntegerに変換します。

BigInteger(byte[] val, int off, int len)

BigIntegerの2つの補完バイナリ表現を含むバイト・サブ配列をBigIntegerに変換します。

BigInteger(int signum, byte[] magnitude)

BigIntegerの符号絶対値表現をBigIntegerに変換します。

BigInteger(int signum, byte[] magnitude, int off, int len)

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に変換します。
メソッドのサマリー

修飾子と型

メソッド

説明

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

parallelMultiply(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

sqrt()

このBigIntegerの整数の平方� �を返します。

BigInteger[]

sqrtAndRemainder()

thisの整数平方� �sとその残りthis - s*sを含む2つのBigIntegersの配列をそれぞれ返します。

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
- TWO
  
  public static final BigInteger TWO
  
  BigInteger定数2。
  
  導入されたバージョン:
  
  9
- TEN
  
  public static final BigInteger TEN
  
  BigInteger定数10です。
  
  導入されたバージョン:
  
  1.5
コンストラクタの詳細
- BigInteger
  
  public BigInteger(byte[] val, int off, int len)
  
  BigIntegerの2つの補完バイナリ表現を含むバイト・サブ配列をBigIntegerに変換します。サブ配列は、配列へのオフセットと長さによって指定されます。サブアレイはbig-endianバイト・オーダーであると仮定される: 最上位バイトはインデックスoffの要� です。 val配列は、コンストラクタ・コール中は変更されないとみなされます。配列valの長さがゼロでなく、offが� 、lenが� 、またはoff+lenがvalの長さより大きい� �合、IndexOutOfBoundsExceptionがスローされます。
  
  パラメータ:
  
  val - BigIntegerのビッグ・エンディアン2の補完バイナリ表現であるサブ配列を含むバイト配列。
  
  off - バイナリ表現の開始オフセット。
  
  len - 使用するバイト数。
  
  スロー:
  
  NumberFormatException - valの長さが0バイトの� �合。
  
  IndexOutOfBoundsException - 指定された配列のオフセットと長さによって、バイト配列への索引が� または配列の長さ以上になる� �合。
  
  導入されたバージョン:
  
  9
- BigInteger
  
  public BigInteger(byte[] val)
  
  BigIntegerの2の補数2進表現を含むバイト配列をBigIntegerに変換します。入力配列はビッグ・エンディアンのバイト� �序(最上位バイトが「0」番目の要� )と見なされます。 val配列は、コンストラクタ・コール中は変更されないとみなされます。
  
  パラメータ:
  
  val - BigIntegerのビッグ・エンディアン2の補完バイナリ表現。
  
  スロー:
  
  NumberFormatException - valの長さが0バイトの� �合。
- BigInteger
  
  public BigInteger(int signum, byte[] magnitude, int off, int len)
  
  BigIntegerの符号絶対値表現をBigIntegerに変換します。符号は整数の符号値(� は -1、ゼロは0、正は1)として表されます。大きさは、big-endianバイト・オーダーのバイト配列のサブ配列です: 最上位バイトはインデックスoffの要� です。長さlenのゼロ値は許可され、シグナ� が -1、0または1のいずれであっても、BigInteger値は0になります。 magnitude配列は、コンストラクタ・コール中は変更されないとみなされます。配列magnitudeの長さがゼロでなく、offが� 、lenが� 、またはoff+lenがmagnitudeの長さより大きい� �合、IndexOutOfBoundsExceptionがスローされます。
  
  パラメータ:
  
  signum - 数字の符号(� は -1、ゼロは0、正は1)。
  
  magnitude - 数字の絶対値のビッグエンディアン・バイナリ表現。
  
  off - バイナリ表現の開始オフセット。
  
  len - 使用するバイト数。
  
  スロー:
  
  NumberFormatException - signumが3つの有効な値(-1、0、1)のどれでもないか、signumが0で、magnitudeに1つ以上の0以外のバイトが含まれている� �合。
  
  IndexOutOfBoundsException - 指定された配列のオフセットと長さによって、バイト配列への索引が� または配列の長さ以上になる� �合。
  
  導入されたバージョン:
  
  9
- BigInteger
  
  public BigInteger(int signum, byte[] magnitude)
  
  BigIntegerの符号絶対値表現をBigIntegerに変換します。符号は整数の符号値(� は -1、ゼロは0、正は1)として表されます。大きさはbig-endianバイト・オーダーのバイト配列です: 最も重要なバイトはゼロ要� です。長さが0の絶対値配列は許容され、符号が -1、0、または1のどれであるかにかかわりなくBigInteger値0となります。 magnitude配列は、コンストラクタ・コール中は変更されないとみなされます。
  
  パラメータ:
  
  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の範囲外にある� �合。
- BigInteger
  
  public BigInteger(String val)
  
  BigIntegerの10進String表現をBigIntegerに変換します。文字列表現は、オプションのマイナス記号またはプラス記号とそれに続く1桁以上の小数で構成されます。文字から数字へのマッピングは、Character.digitによって提供されます。 Stringには、不適切な文字(空白など)を含めることはできません。
  
  パラメータ:
  
  val - BigIntegerの10進数のString表現。
  
  スロー:
  
  NumberFormatException - valはBigIntegerの表現としては無効である。
- 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を、指定したビット長で構築します。
  
  APIのノート:
  
  確実性を指定する必要がない� �合は、このコンストラクタではなく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はありません。
  
  実装上のノート:
  
  基礎となるアルゴリズ� の性質により、thisのサイズに応じて、このメソッドは大量のメモリーを消費したり、使用可能なヒープ� �域を最大限に消費したり、長時間実行したりできます。
  
  戻り値:
  
  このBigIntegerより大きい最初の整数(おそらく� 数)。
  
  スロー:
  
  ArithmeticException - this < 0であるか、thisが大きすぎる� �合。
  
  導入されたバージョン:
  
  1.5
- valueOf
  
  public static BigInteger valueOf(long val)
  
  値が指定されたlongの値と等しいBigIntegerを返します。
  
  APIのノート:
  
  この静的ファクトリ・メソッドは、� �繁に使用されるBigIntegersを再利用できるため、(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 == thisの� �合、実装のアルゴリズ� 的パフォーマンスが向上することがあります。
  
  パラメータ:
  
  val - このBigIntegerで乗算する値。
  
  戻り値:
  
  this * val
- parallelMultiply
  public BigInteger parallelMultiply(BigInteger val)
  
  値が(this * val)であるBigIntegerを返します。 thisとvalの両方が大きい� �合(通常は数千ビット)、並列乗算が使用されます。このメソッドは、multiply(java.math.BigInteger)とまったく同じ数学結果を返します。
  
  実装上のノート:
  
  この実装では、val == this.とmultiply(java.math.BigInteger)を比較すると、アルゴリズ� のパフォーマンスが向上する可能性があります。実装のパラレル乗算アルゴリズ� では通常、結果をより速くコンピュートするためにより多くのCPUリソースが使用され、メモリー消費がわずかに増� する� �合があります。
  
  パラメータ:
  
  val - このBigIntegerで乗算する値。
  
  戻り値:
  
  this * val
  
  導入されたバージョン:
  
  19
  
  関連� �目:
  
  multiply(java.math.BigInteger)
- 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が� の� �合。 (非整数値を生成する演算が生じる。)
- sqrt
  
  public BigInteger sqrt()
  
  このBigIntegerの整数の平方� �を返します。対応する数学的整数nの整数平方� �は、s*s <= nのような最大の数学的整数sです。これは、floor(sqrt(n))の値と等しくなります。ここで、sqrt(n)は、実数として扱われるnの実平方� �を示します。整数平方� �は、後者が整数値として表現できない� �合、実平方� �より小さくなります。
  
  戻り値:
  
  thisの整数平方� �
  
  スロー:
  
  ArithmeticException - thisが� の� �合。 (� の整数valの平方� �は(i * sqrt(-val))であり、ここで、iは「虚数単位」であり、sqrt(-1)と等しい。)
  
  導入されたバージョン:
  
  9
- sqrtAndRemainder
  public BigInteger[] sqrtAndRemainder()
  
  thisの整数平方� �sとその残りthis - s*sを含む2つのBigIntegersの配列をそれぞれ返します。
  
  戻り値:
  
  オフセットが0の整数平方� �、オフセットが1の余りの2つのBigIntegerの配列
  
  スロー:
  
  ArithmeticException - thisが� の� �合。 (� の整数valの平方� �は(i * sqrt(-val))であり、ここで、iは「虚数単位」であり、sqrt(-1)と等しい。)
  
  導入されたバージョン:
  
  9
  
  関連� �目:
  
  sqrt()
- 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進表現におけるビットの数に等しくなります。ゼロの� �合、このメソッドは0を返します。 ((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が返されます。
  
  実装上のノート:
  
  基礎となるプライマリティ・テスト・アルゴリズ� の性質、およびthisとcertaintyのサイズによっては、このメソッドは大量のメモリーを消費したり、使用可能なヒープ� �域を最大限に消費したり、長時間実行したりできます。
  
  パラメータ:
  
  certainty - 呼出し側が許容できる不確実性の程度。この呼出しがtrueを返す� �合、このBigIntegerが� 数である確率は(1 - 1/2^certainty)を超えます。このメソッドの実行時間はこのパラメータの値に比例します。
  
  戻り値:
  
  このBigIntegerが� 数である可能性が高い� �合はtrue、必ず合成数である� �合はfalse。
  
  スロー:
  
  ArithmeticException - thisが大きすぎます。
- 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に変換します。この変換は、longからintへのプリミティブ変換を狭めるに似ています。Java言語仕様で定義されています: このBigIntegerが大きすぎてintに収まらない� �合は、下位32ビットのみが返されます。この変換により、このBigInteger値の絶対値全体に関する情� �が失われ、逆の符号で返される可能性があります。
  
  定義:
  
  intValue、クラスNumber
  
  戻り値:
  
  intに変換されたこのBigInteger。
  
  Java言語仕様を参照してく� さい:
  
  5.1.3 プリミティブ・コンバージョンの解説
  
  関連� �目:
  
  intValueExact()
- longValue
  public long longValue()
  
  このBigIntegerをlongに変換します。この変換は、longからintへのプリミティブ変換を狭めるに似ています。Java言語仕様で定義されています: このBigIntegerが大きすぎてlongに収まらない� �合は、下位64ビットのみが返されます。この変換により、このBigInteger値の絶対値全体に関する情� �が失われ、逆の符号で返される可能性があります。
  
  定義:
  
  longValue、クラスNumber
  
  戻り値:
  
  longに変換されたこのBigInteger。
  
  Java言語仕様を参照してく� さい:
  
  5.1.3 プリミティブ・コンバージョンの解説
  
  関連� �目:
  
  longValueExact()
- floatValue
  
  public float floatValue()
  
  このBigIntegerをfloatに変換します。この変換は、Java言語仕様で定義されているdoubleからfloatへのプリミティブ変換を狭めるに似ています: このBigIntegerが大きすぎてfloatとして表現できない� �合は、必要に応じてFloat.NEGATIVE_INFINITYまたはFloat.POSITIVE_INFINITYに変換されます。戻り値が有限である� �合も、この変換により、BigInteger値の精度に関する情� �が失われる可能性があります。
  
  定義:
  
  floatValue、クラスNumber
  
  戻り値:
  
  floatに変換されたこのBigInteger。
  
  Java言語仕様を参照してく� さい:
  
  5.1.3 プリミティブ・コンバージョンの解説
- doubleValue
  
  public double doubleValue()
  
  このBigIntegerをdoubleに変換します。この変換は、Java言語仕様で定義されているdoubleからfloatへのプリミティブ変換を狭めるに似ています: このBigIntegerが大きすぎてdoubleとして表現できない� �合は、必要に応じてDouble.NEGATIVE_INFINITYまたはDouble.POSITIVE_INFINITYに変換されます。戻り値が有限である� �合も、この変換により、BigInteger値の精度に関する情� �が失われる可能性があります。
  
  定義:
  
  doubleValue、クラスNumber
  
  戻り値:
  
  doubleに変換されたこのBigInteger。
  
  Java言語仕様を参照してく� さい:
  
  5.1.3 プリミティブ・コンバージョンの解説
- 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()

クラスBigInteger

フィールドのサマリー

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

メソッドのサマリー

クラスjava.lang.Numberで宣言されたメソッド

クラスjava.lang.Objectで宣言されたメソッド

フィールド詳細

ZERO

ONE

TWO

TEN

コンストラクタの詳細

BigInteger

BigInteger

BigInteger

BigInteger

BigInteger

BigInteger

BigInteger

BigInteger

メソッドの詳細

probablePrime

nextProbablePrime

valueOf

add

subtract

multiply

parallelMultiply

divide

divideAndRemainder

remainder

pow

sqrt

sqrtAndRemainder

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