Класс BigInteger

public static final BigInteger ZERO

С:

1.2

public static final BigInteger ONE

С:

1.2

public static final BigInteger TWO

С:

9

public static final BigInteger TEN

С:

1.5

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

Параметры:

val - массив байтов, содержащий подмассив, являющийся двоичным представлением BigInteger в дополнении до двух в формате big-endian.

off - начальное смещение двоичного представления.

len - количество байтов для использования.

Исключения:

NumberFormatException - val имеет нулевую длину.

IndexOutOfBoundsException - если предоставленные смещение и длина массива вызовут отрицательный или равный или больший, чем длина массива, индекс.

С:

9

public BigInteger(byte[] val)

Параметры:

val - двоичное представление BigInteger в дополнении до двух в формате big-endian.

Исключения:

NumberFormatException - val имеет нулевую длину.

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

Параметры:

signum - signum числа (-1 для отрицательного, 0 для нуля, 1 для положительного).

magnitude - big-endian двоичное представление абсолютного значения числа.

off - начальное смещение двоичного представления.

len - количество байтов для использования.

Исключения:

NumberFormatException - signum не равно одному из трёх допустимых значений (-1, 0 и 1) или signum равно 0 и magnitude содержит один или несколько ненулевых байтов.

IndexOutOfBoundsException - если предоставленные смещение и длина массива вызовут отрицательный или равный или больший, чем длина массива, индекс.

С:

9

public BigInteger(int signum, byte[] magnitude)

Параметры:

signum - signum числа (-1 для отрицательного, 0 для нуля, 1 для положительного).

magnitude - big-endian двоичное представление величины числа.

Исключения:

NumberFormatException - signum не равно одному из трёх допустимых значений (-1, 0 и 1) или signum равно 0 и magnitude содержит один или несколько ненулевых байтов.

public BigInteger(String val, int radix)

Параметры:

val - строковое представление BigInteger.

radix - радикс, используемый при интерпретации val.

Исключения:

NumberFormatException - val не является корректным представлением BigInteger в указанном радиксе или radix находится вне диапазона от Character.MIN_RADIX до Character.MAX_RADIX включительно.

public BigInteger(String val)

Параметры:

val - десятичное строковое представление BigInteger.

Исключения:

NumberFormatException - val не является корректным представлением BigInteger.

public BigInteger(int numBits, Random rnd)

Параметры:

numBits - максимальная bitLength нового BigInteger.

rnd - источник случайности, используемый для вычисления нового BigInteger.

Исключения:

IllegalArgumentException - numBits отрицательно.

См. также:

• bitLength()

public BigInteger(int bitLength, int certainty, Random rnd)

Примечание API:

Рекомендуется использовать метод probablePrime вместо этого конструктора, если нет веской причины для указания certainty.

Параметры:

bitLength - bitLength возвращаемого BigInteger.

certainty - мера неопределённости, которую вызывающий код готов принять. Вероятность того, что новый BigInteger представляет собой простое число, будет больше (1 - 1/2^certainty). Время выполнения этого конструктора пропорционально значению этого параметра.

rnd - источник случайных битов, используемых для выбора кандидатов, которые будут проверены на простоту.

Исключения:

ArithmeticException - bitLength < 2 или bitLength слишком велики.

См. также:

• bitLength()

public static BigInteger probablePrime(int bitLength, Random rnd)

Parameters:

bitLength - длина в битах возвращаемого BigInteger.

rnd - источник случайных битов, используемых для выбора кандидатов, которые будут проверяться на простоту.

Returns:

BigInteger с bitLength битами, который, вероятно, является простым

Throws:

ArithmeticException - bitLength < 2 или bitLength слишком велики.

Since:

1.4

See Also:

• bitLength()

public BigInteger nextProbablePrime()

Implementation Note:

Из-за особенностей базового алгоритма и в зависимости от размера this, этот метод может потребовать значительного объёма памяти, до исчерпания доступного пространства кучи, или может выполняться длительное время.

Returns:

первое целое число, большее этого BigInteger, которое, вероятно, является простым.

Throws:

ArithmeticException - this < 0 или this слишком велики.

Since:

1.5

public static BigInteger valueOf(long val)

API Note:

Этот статический фабричный метод предоставляется в приоритете перед (long) конструктором, потому что он позволяет повторно использовать часто используемые BigInteger.

Parameters:

val - значение возвращаемого BigInteger.

Returns:

BigInteger с заданным значением.

public BigInteger add(BigInteger val)

Parameters:

val - значение, которое нужно добавить к этому BigInteger.

Returns:

this + val

public BigInteger subtract(BigInteger val)

Parameters:

val - значение, которое нужно вычесть из этого BigInteger.

Returns:

this - val

public BigInteger multiply(BigInteger val)

Implementation Note:

Реализация может предложить лучшую алгоритмическую производительность, когда val == this.

Parameters:

val - значение, которое нужно умножить на этот BigInteger.

Returns:

this * val

public BigInteger parallelMultiply(BigInteger val)

Implementation Note:

Эта реализация может предложить лучшую алгоритмическую производительность, когда val == this., По сравнению с multiply(java.math.BigInteger), алгоритм параллельного умножения реализации обычно использует больше ресурсов процессора для более быстрого вычисления результата, и может делать это с небольшим увеличением потребления памяти.

Parameters:

val - значение, которое нужно умножить на этот BigInteger.

Returns:

this * val

Since:

19

See Also:

• multiply(java.math.BigInteger)

public BigInteger divide(BigInteger val)

Parameters:

val - значение, на которое нужно разделить этот BigInteger.

Returns:

this / val

Throws:

ArithmeticException - если val равно нулю.

public BigInteger[] divideAndRemainder(BigInteger val)

Parameters:

val - значение, на которое нужно разделить этот BigInteger и вычислить остаток.

Returns:

массив из двух BigInteger: частное (this / val) — это начальный элемент, а остаток (this % val) — это конечный элемент.

Throws:

ArithmeticException - если val равно нулю.

public BigInteger remainder(BigInteger val)

Parameters:

val - значение, на которое нужно разделить этот BigInteger и вычислить остаток.

Returns:

this % val

Throws:

ArithmeticException - если val равно нулю.

public BigInteger pow(int exponent)

Parameters:

exponent - показатель степени, до которого нужно возвести этот BigInteger.

Returns:

thisexponent

Throws:

ArithmeticException - exponent отрицательно. (Это привело бы к тому, что операция даст нецелое значение.)

public BigInteger sqrt()

Returns:

целая квадратная корень из this

Throws:

ArithmeticException - если this отрицательно. (Квадратный корень из отрицательного целого числа val — это (i * sqrt(-val)), где i — мнимая единица и равно sqrt(-1).)

Since:

9

public BigInteger[] sqrtAndRemainder()

Returns:

массив из двух BigInteger с целой квадратной коренью в смещении 0 и остатком в смещении 1

Throws:

ArithmeticException - если this отрицательно. (Квадратный корень из отрицательного целого числа val — это (i * sqrt(-val)), где i — мнимая единица и равно sqrt(-1).)

Since:

9

See Also:

• sqrt()

public BigInteger gcd(BigInteger val)

Parameters:

val - значение, с которым нужно вычислить НОД.

Returns:

GCD(abs(this), abs(val))

public BigInteger abs()

Returns:

abs(this)

public BigInteger negate()

Returns:

-this

public int signum()

Returns:

-1, 0 или 1, в зависимости от того, является ли значение этого BigInteger отрицательным, нулевым или положительным.

public BigInteger mod(BigInteger m)

Параметры:

m - модуль.

Возвращает:

this mod m

Исключения:

ArithmeticException - m ≤ 0

См. также:

• remainder(java.math.BigInteger)

public BigInteger modPow(BigInteger exponent, BigInteger m)

Параметры:

exponent - показатель степени.

m - модуль.

Возвращает:

thisexponent mod m

Исключения:

ArithmeticException - m ≤ 0 или показатель степени отрицательный, и этот BigInteger не взаимно прост с m.

См. также:

• modInverse(java.math.BigInteger)

public BigInteger modInverse(BigInteger m)

Параметры:

m - модуль.

Возвращает:

this^-1 mod m.

Исключения:

ArithmeticException - m ≤ 0, или этот BigInteger не имеет мультипликативного обратного по модулю m (то есть, этот BigInteger не взаимно прост с m).

public BigInteger shiftLeft(int n)

Параметры:

n - расстояние сдвига, в битах.

Возвращает:

this << n

См. также:

• shiftRight(int)

public BigInteger shiftRight(int n)

Параметры:

n - расстояние сдвига, в битах.

Возвращает:

this >> n

См. также:

• shiftLeft(int)

public BigInteger and(BigInteger val)

Параметры:

val - значение, которое нужно выполнить операцию AND с этим BigInteger.

Возвращает:

this & val

public BigInteger or(BigInteger val)

Параметры:

val - значение, которое нужно выполнить операцию OR с этим BigInteger.

Возвращает:

this | val

public BigInteger xor(BigInteger val)

Параметры:

val - значение, которое нужно выполнить операцию XOR с этим BigInteger.

Возвращает:

this ^ val

public BigInteger not()

Возвращает:

~this

public BigInteger andNot(BigInteger val)

Параметры:

val - значение, которое нужно инвертировать и выполнить операцию AND с этим BigInteger.

Возвращает:

this & ~val

public boolean testBit(int n)

Параметры:

n - индекс бита для проверки.

Возвращает:

true тогда и только тогда, когда заданный бит установлен.

Исключения:

ArithmeticException - n отрицателен.

public BigInteger setBit(int n)

Параметры:

n - индекс бита для установки.

Возвращает:

this | (1<<n)

Исключения:

ArithmeticException - n отрицателен.

public BigInteger clearBit(int n)

Параметры:

n - индекс бита для очистки.

Возвращает:

this & ~(1<<n)

Исключения:

ArithmeticException - n отрицателен.

public BigInteger flipBit(int n)

Параметры:

n - индекс бита для инвертирования.

Возвращает:

this ^ (1<<n)

Исключения:

ArithmeticException - n отрицателен.

public int getLowestSetBit()

Возвращает:

индекс самого правого единичного бита в этом BigInteger.

public int bitLength()

Возвращает:

количество битов в минимальном представлении этого BigInteger в дополнительном коде, исключая знак.

public int bitCount()

Возвращает:

количество битов в представлении этого BigInteger в дополнительном коде, которые отличаются от его знака.

public boolean isProbablePrime(int certainty)

Примечание по реализации:

Из-за характера базового алгоритма проверки на простоту и в зависимости от размера this и certainty, этот метод может потреблять большое количество памяти, вплоть до исчерпания доступного пространства кучи, или может выполняться в течение длительного времени.

Параметры:

certainty - мера неопределенности, которую вызывающая сторона готова допустить: если вызов возвращает true, вероятность того, что этот BigInteger является простым, превышает (1 - 1/2^certainty). Время выполнения этого метода пропорционально значению этого параметра.

Возвращает:

true, если этот BigInteger, вероятно, простой, false, если он определенно составной.

Исключения:

ArithmeticException - this слишком велико.

public int compareTo(BigInteger val)

Определено в:

compareTo в интерфейсе Comparable<BigInteger>

Параметры:

val — BigInteger, с которым должен быть сравнен этот BigInteger.

Возвращает:

-1, 0 или 1, если этот BigInteger численно меньше, равен или больше val.

public boolean equals(Object x)

Переопределяет:

equals в классе Object

Параметры:

x — Объект, с которым должен быть сравнен этот BigInteger.

Возвращает:

true тогда и только тогда, когда указанный объект является BigInteger, значение которого численно равно этому BigInteger.

См. также:

• Object.hashCode()
• HashMap

public BigInteger min(BigInteger val)

Параметры:

val — значение, с которым вычисляется минимум.

Возвращает:

BigInteger, значение которого является меньшим из этого BigInteger и val. Если они равны, может быть возвращено любое из них.

public BigInteger max(BigInteger val)

Параметры:

val — значение, с которым вычисляется максимум.

Возвращает:

BigInteger, значение которого является большим из этого и val. Если они равны, может быть возвращено любое из них.

public int hashCode()

Переопределяет:

hashCode в классе Object

Возвращает:

код хэша для этого BigInteger

См. также:

• Object.equals(java.lang.Object)
• System.identityHashCode(java.lang.Object)

public String toString(int radix)

Параметры:

radix — радис строкового представления.

Возвращает:

строковое представление этого BigInteger в заданном радисе.

См. также:

• Integer.toString(int, int)
• Character.forDigit(int, int)
• BigInteger(java.lang.String, int)

public String toString()

Переопределяет:

toString в классе Object

Возвращает:

десятичное строковое представление этого BigInteger.

См. также:

• Character.forDigit(int, int)
• BigInteger(java.lang.String)

public byte[] toByteArray()

Возвращает:

массив байтов, содержащий представление этого BigInteger в дополнительном коде.

См. также:

• BigInteger(byte[])

public int intValue()

Определено в:

intValue в классе Number

Возвращает:

этот BigInteger, преобразованный в целое число типа int.

См. Спецификацию языка Java:

5.1.3 Узкое примитивное преобразование

См. также:

• intValueExact()

public long longValue()

Определено в:

longValue в классе Number

Возвращает:

этот BigInteger, преобразованный в длинное целое число типа long.

См. Спецификацию языка Java:

5.1.3 Узкое примитивное преобразование

См. также:

• longValueExact()

public float floatValue()

Определено в:

floatValue в классе Number

Возвращает:

этот BigInteger, преобразованный в число с плавающей точкой типа float.

См. Спецификацию языка Java:

5.1.3 Узкое примитивное преобразование

public double doubleValue()

Определено в:

doubleValue в классе Number

Возвращает:

этот BigInteger, преобразованный в число с плавающей точкой двойной точности типа double.

См. Спецификацию языка Java:

5.1.3 Узкое примитивное преобразование

public long longValueExact()

Возвращает:

Этот BigInteger, преобразованный в long.

Использует:

ArithmeticException - если значение this не помещается точно в long.

С:

1.8

См. также:

• longValue()

public int intValueExact()

Возвращает:

Этот BigInteger, преобразованный в int.

Использует:

ArithmeticException - если значение this не помещается точно в int.

С:

1.8

См. также:

• intValue()

public short shortValueExact()

Возвращает:

Этот BigInteger, преобразованный в short.

Использует:

ArithmeticException - если значение this не помещается точно в short.

С:

1.8

См. также:

• Number.shortValue()

public byte byteValueExact()

Возвращает:

Этот BigInteger, преобразованный в byte.

Использует:

ArithmeticException - если значение this не помещается точно в byte.

С:

1.8

См. также:

• Number.byteValue()