BigInteger (Платформа Java SE 7)

java.lang. Объект
- java.lang. Число
- - java.math. BigInteger

Все Реализованные Интерфейсы:

Сериализуемый, Сопоставимый <BigInteger>
```
public class BigInteger
extends Number
implements Comparable<BigInteger>
```
Неизменные целые числа произвольной точности. Все операции ведут себя, как будто BigIntegers были представлены в two's-дополнительной нотации (как примитивные целочисленные типы Java). BigInteger обеспечивает аналоги всем примитивным целочисленным операторам Java, и все соответствующие методы от java.lang. Математика. Дополнительно, BigInteger обеспечивает операции для арифметики в остаточных классах, вычисления GCD, тестирования простоты чисел, главной генерации, побитовой обработки, и нескольких других разных операций.
Семантика арифметических операций точно подражает таковым из целочисленных арифметических операторов Java, как определено в Спецификации языка Java. Например, подразделение нулем бросает ArithmeticException, и подразделение отрицания положительные урожаи отрицание (или нуль) остаток. Все детали в Спецификации относительно переполнения игнорируются, поскольку BigIntegers делаются как большие по мере необходимости, чтобы разместить результаты работы.
Семантика операций сдвига расширяет таковые из операторов сдвига Java, чтобы учесть отрицательные расстояния сдвига. Сдвиг вправо с отрицательным расстоянием сдвига приводит к сдвигу влево, и наоборот. Оператор сдвига вправо без знака (>>>) опускается, поскольку эта работа имеет небольшой смысл в комбинации с "бесконечной абстракцией" размера слова, обеспеченной этим классом.
Семантика поразрядных логических операций точно подражает таковым из поразрядных целочисленных операторов Java. Бинарные операторы (and, or, xor) неявно выполните расширение знака на короче этих двух операндов до выполнения работы.
Операции сравнения выполняют сравнения целого числа со знаком, аналогичные выполняемым реляционным Java и операторы равенства.
Операции арифметики в остаточных классах обеспечиваются, чтобы вычислить остатки, выполнить возведение в степень, и вычислить мультипликативные инверсии. Эти методы всегда возвращают неотрицательный результат, между 0 и (modulus - 1), включительно.
Битовые операции работают на единственном бите two's-дополнительного представления их операнда. В случае необходимости операнд является знаком - расширялся так, чтобы это содержало определяемый бит. Ни одна из одно-разрядных операций не может произвести BigInteger с различным знаком от BigInteger, управляемого на, поскольку они влияют на только единственный бит, и "бесконечная абстракция" размера слова, обеспеченная этим классом, гарантирует, что есть бесконечно много "виртуальных знаковых битов", предшествующих каждому BigInteger.
Ради краткости и ясности, псевдокод используется всюду по описаниям методов BigInteger. Выражение псевдокода (i + j) сокращение для "BigInteger, значение которого является значением BigInteger i плюс тот из BigInteger j." Выражение псевдокода (i == j) сокращение для"true если и только если BigInteger i представляет то же самое значение как BigInteger j." Другие выражения псевдокода интерпретируются так же.
Все методы и конструкторы в этом броске класса NullPointerException когда передано нулевая ссылка на объект для любого входного параметра.

С тех пор:

JDK1.1

См. Также:
BigDecimal, Сериализированная Форма

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`static BigInteger`	`ОДИН` BigInteger постоянный.
`static BigInteger`	`ДЕСЯТЬ` BigInteger постоянные десять.
`static BigInteger`	`НУЛЬ` BigInteger постоянный нуль.

Сводка конструктора

Конструкторы
Конструктор и Описание
`BigInteger(byte[] val)` Преобразовывает байтовый массив, содержащий two's-дополнительное двоичное представление 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 к (2^numBits - 1), включительно.
`BigInteger(String val)` Преобразовывает десятичное Строковое представление BigInteger в BigInteger.
`BigInteger(String val, int radix)` Преобразовывает Строковое представление BigInteger в указанном основании в BigInteger.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`BigInteger`	`abs()` Возвращает BigInteger, значение которого является абсолютным значением этого BigInteger.
`BigInteger`	`add(BigInteger val)` Возвращает BigInteger, значение которого `(this + val)`.
`BigInteger`	`and(BigInteger val)` Возвращает BigInteger, значение которого `(this & val)`.
`BigInteger`	`andNot(BigInteger val)` Возвращает BigInteger, значение которого `(this & ~val)`.
`int`	`bitCount()` Возвращает число битов в дополнительном представлении two этого BigInteger, которые отличаются от его знакового бита.
`int`	`bitLength()` Возвращает число битов в минимальном two's-дополнительном представлении этого BigInteger, исключая знаковый бит.
`BigInteger`	`clearBit(int n)` Возвращает BigInteger, значение которого эквивалентно этому BigInteger с определяемым очищенным битом.
`int`	`compareTo(BigInteger val)` Сравнивает этот BigInteger с указанным BigInteger.
`BigInteger`	`divide(BigInteger val)` Возвращает BigInteger, значение которого `(this / val)`.
`BigInteger[]`	`divideAndRemainder(BigInteger val)` Возвращает массив двух BigIntegers, содержащих `(this / val)` сопровождаемый `(this % val)`.
`double`	`doubleValue()` Преобразовывает этот BigInteger в a `double`.
`boolean`	`equals(Object x)` Сравнивает этот BigInteger с указанным Объектом для равенства.
`BigInteger`	`flipBit(int n)` Возвращает BigInteger, значение которого эквивалентно этому BigInteger с определяемым зеркально отраженным битом.
`float`	`floatValue()` Преобразовывает этот BigInteger в a `float`.
`BigInteger`	`gcd(BigInteger val)` Возвращает BigInteger, значение которого является наибольшим общим делителем `abs(this)` и `abs(val)`.
`int`	`getLowestSetBit()` Возвращает индекс самого правого одного бита (самого низкоуровневого) в этом BigInteger (число нулевых битов направо от самого правого одного бита).
`int`	`hashCode()` Возвращает хэш-код для этого BigInteger.
`int`	`intValue()` Преобразовывает этот BigInteger в `int`.
`boolean`	`isProbablePrime(int certainty)` Возвраты `true` если этот BigInteger является, вероятно, главным, `false` если это - определенно составной объект.
`long`	`longValue()` Преобразовывает этот BigInteger в a `long`.
`BigInteger`	`max(BigInteger val)` Возвращает максимум этого BigInteger и `val`.
`BigInteger`	`min(BigInteger val)` Возвращает минимум этого BigInteger и `val`.
`BigInteger`	`mod(BigInteger m)` Возвращает BigInteger, значение которого `(this mod m`).
`BigInteger`	`modInverse(BigInteger m)` Возвращает BigInteger, значение которого `(this`^-1 `mod m)`.
`BigInteger`	`modPow(BigInteger exponent, BigInteger m)` Возвращает BigInteger, значением которого является `^{(thisexponent mod m)}`.
`BigInteger`	`multiply(BigInteger val)` Возвращает BigInteger, значение которого `(this * val)`.
`BigInteger`	`negate()` Возвращает BigInteger, значение которого `(-this)`.
`BigInteger`	`nextProbablePrime()` Возвращает первое целое число, больше чем это `BigInteger` это является, вероятно, главным.
`BigInteger`	`not()` Возвращает BigInteger, значение которого `(~this)`.
`BigInteger`	`or(BigInteger val)` Возвращает BigInteger, значение которого `(this \| val)`.
`BigInteger`	`pow(int exponent)` Возвращает BigInteger, значением которого является `^{(thisexponent)}`.
`static BigInteger`	`probablePrime(int bitLength, Random rnd)` Возвращает положительный BigInteger, который является, вероятно, главным с указанным bitLength.
`BigInteger`	`remainder(BigInteger val)` Возвращает BigInteger, значение которого `(this % val)`.
`BigInteger`	`setBit(int n)` Возвращает BigInteger, значение которого эквивалентно этому BigInteger с определяемым набором битов.
`BigInteger`	`shiftLeft(int n)` Возвращает BigInteger, значение которого `(this << n)`.
`BigInteger`	`shiftRight(int n)` Возвращает BigInteger, значение которого `(this >> n)`.
`int`	`signum()` Возвращает сигнум-функцию этого BigInteger.
`BigInteger`	`subtract(BigInteger val)` Возвращает BigInteger, значение которого `(this - val)`.
`boolean`	`testBit(int n)` Возвраты `true` если и только если определяемый бит устанавливается.
`byte[]`	`toByteArray()` Возвращает байтовый массив, содержащий two's-дополнительное представление этого BigInteger.
`Строка`	`toString()` Возвращает десятичное Строковое представление этого BigInteger.
`Строка`	`toString(int radix)` Возвращает Строковое представление этого BigInteger в данном основании.
`static BigInteger`	`valueOf(long val)` Возвращает BigInteger, значение которого равно тому из указанных `long`.
`BigInteger`	`xor(BigInteger val)` Возвращает BigInteger, значение которого `(this ^ val)`.

Методы java.lang унаследованный от класса. Число
byteValue, shortValue

Методы java.lang унаследованный от класса. Объект
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Полевая Деталь
  - НУЛЬ
```
public static final BigInteger ZERO
```
    BigInteger постоянный нуль.
    
    С тех пор:
    
    1.2
  - ОДИН
```
public static final BigInteger ONE
```
    BigInteger постоянный.
    
    С тех пор:
    
    1.2
  - ДЕСЯТЬ
```
public static final BigInteger TEN
```
    BigInteger постоянные десять.
    
    С тех пор:
    
    1.5
- Деталь конструктора
  - BigInteger
```
public BigInteger(byte[] val)
```
    Преобразовывает байтовый массив, содержащий two's-дополнительное двоичное представление BigInteger в BigInteger. Входной массив, как предполагается, находится в порядке байтов с обратным порядком байтов: старший значащий байт в своей стихии.
    
    Параметры:
    val - two's-дополнительное двоичное представление с обратным порядком байтов BigInteger.
    
    Броски:
    
    NumberFormatException - val нулевые байты долго.
  - BigInteger
```
public BigInteger(int signum,
          byte[] magnitude)
```
    Преобразовывает представление величины знака BigInteger в BigInteger. Знак представляется как целочисленное значение знака:-1 для отрицательного, 0 для нуля, или 1 для положительного. Величина является байтовым массивом в порядке байтов с обратным порядком байтов: старший значащий байт в своей стихии. Массив величины нулевой длиной допустим, и приведет к значению BigInteger 0, является ли знак-1, 0 или 1.
    
    Параметры:
    signum - знак числа (-1 для отрицательного, 0 для нуля, 1 для положительного).
    magnitude - двоичное представление с обратным порядком байтов величины числа.
    
    Броски:
    
    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. Отметьте, что этот конструктор всегда создает неотрицательный BigInteger.
    
    Параметры:
    numBits - максимум bitLength нового BigInteger.
    rnd - источник случайности, которая будет использоваться в вычислениях нового BigInteger.
    
    Броски:
    
    IllegalArgumentException - numBits отрицательно.
    См. Также:
    bitLength()
  - BigInteger
```
public BigInteger(int bitLength,
          int certainty,
          Random rnd)
```
    Создает в произвольном порядке сгенерированный положительный BigInteger, который является, вероятно, главным с указанным bitLength.
    Рекомендуется что probablePrime метод использоваться в предпочтении к этому конструктору, если нет неотразимая потребность определить уверенность.
    
    Параметры:
    bitLength - bitLength возвращенного BigInteger.
    certainty - мера неопределенности, которую вызывающая сторона готова терпеть. Вероятность, что новый BigInteger представляет простое число, превысит (1 - 1/2^certainty). Время выполнения этого конструктора пропорционально значению этого параметра.
    rnd - источник случайных битов, используемых, чтобы выбрать кандидатов, которые будут протестированы на простоту чисел.
    
    Броски:
    
    ArithmeticException - bitLength < 2.
    См. Также:
    bitLength()
- Деталь метода
  - probablePrime
```
public static BigInteger probablePrime(int bitLength,
                       Random rnd)
```
    Возвращает положительный BigInteger, который является, вероятно, главным с указанным bitLength. Вероятность, что BigInteger, возвращенный этим методом, является составным объектом, не превышает ^2-100.
    
    Параметры:
    bitLength - bitLength возвращенного BigInteger.
    rnd - источник случайных битов, используемых, чтобы выбрать кандидатов, которые будут протестированы на простоту чисел.
    
    Возвраты:
    BigInteger bitLength биты, который является, вероятно, главным
    
    Броски:
    
    ArithmeticException - bitLength < 2.
    С тех пор:
    
    1.4
    
    См. Также:
    bitLength()
  - nextProbablePrime
```
public BigInteger nextProbablePrime()
```
    Возвращает первое целое число, больше чем это BigInteger это является, вероятно, главным. Вероятность, что число, возвращенное этим методом, является составным объектом, не превышает ^2-100. Этот метод никогда не будет перескакивать через начало, ища: если это возвращается p, нет никакого начала q так, что this < q < p.
    
    Возвраты:
    первое целое число, больше чем это BigInteger это является, вероятно, главным.
    
    Броски:
    
    ArithmeticException - this < 0.
    С тех пор:
    
    1.5
  - valueOf
```
public static BigInteger valueOf(long val)
```
    Возвращает BigInteger, значение которого равно тому из указанных long. Этот "статический метод фабрики" обеспечивается в предпочтении к (long) конструктор, потому что это учитывает повторное использование часто используемого BigIntegers.
    
    Параметры:
    val - значение BigInteger, чтобы возвратиться.
    
    Возвраты:
    BigInteger с указанным значением.
  - добавить
```
public BigInteger add(BigInteger val)
```
    Возвращает BigInteger, значение которого (this + val).
    
    Параметры:
    val - значение, которое будет добавлено к этому BigInteger.
    
    Возвраты:
    this + val
  - вычесть
```
public BigInteger subtract(BigInteger val)
```
    Возвращает BigInteger, значение которого (this - val).
    
    Параметры:
    val - значение, которое будет вычтено из этого BigInteger.
    
    Возвраты:
    this - val
  - умножиться
```
public BigInteger multiply(BigInteger val)
```
    Возвращает BigInteger, значение которого (this * val).
    
    Параметры:
    val - значение, которое будет умножено на этот BigInteger.
    
    Возвраты:
    this * val
  - разделиться
```
public BigInteger divide(BigInteger val)
```
    Возвращает BigInteger, значение которого (this / val).
    
    Параметры:
    val - значение, на которое должен быть разделен этот BigInteger.
    
    Возвраты:
    this / val
    
    Броски:
    
    ArithmeticException - если val нуль.
  - divideAndRemainder
```
public BigInteger[] divideAndRemainder(BigInteger val)
```
    Возвращает массив двух BigIntegers, содержащих (this / val) сопровождаемый (this % val).
    
    Параметры:
    val - значение, на которое этот BigInteger должен быть разделен, и вычисленный остаток.
    
    Возвраты:
    массив двух BigIntegers: частное (this / val) начальный элемент, и остаток (this % val) заключительный элемент.
    
    Броски:
    
    ArithmeticException - если val нуль.
  - остаток
```
public BigInteger remainder(BigInteger val)
```
    Возвращает BigInteger, значение которого (this % val).
    
    Параметры:
    val - значение, на которое этот BigInteger должен быть разделен, и вычисленный остаток.
    
    Возвраты:
    this % val
    
    Броски:
    
    ArithmeticException - если val нуль.
  - голова
```
public BigInteger pow(int exponent)
```
    Возвращает BigInteger, значением которого является ^{(thisexponent)}. Отметьте это exponent целое число, а не BigInteger.
    
    Параметры:
    exponent - экспонента, до которой должен быть повышен этот BigInteger.
    
    Возвраты:
    ^thisexponent
    
    Броски:
    
    ArithmeticException - exponent отрицательно. (Это заставило бы работу приводить к значению нецелого числа.)
  - НОД
```
public BigInteger gcd(BigInteger val)
```
    Возвращает BigInteger, значение которого является наибольшим общим делителем abs(this) и abs(val). Возвраты 0, если this==0 && val==0.
    
    Параметры:
    val - значение, с которым должен быть вычислен GCD.
    
    Возвраты:
    GCD(abs(this), abs(val))
  - abs
```
public BigInteger abs()
```
    Возвращает BigInteger, значение которого является абсолютным значением этого BigInteger.
    
    Возвраты:
    abs(this)
  - инвертировать
```
public BigInteger negate()
```
    Возвращает BigInteger, значение которого (-this).
    
    Возвраты:
    -this
  - знак
```
public int signum()
```
    Возвращает сигнум-функцию этого BigInteger.
    
    Возвраты:
    -1, 0 или 1, поскольку значение этого BigInteger отрицательно, нуль или положительно.
  - модник
```
public BigInteger mod(BigInteger m)
```
    Возвращает BigInteger, значение которого (this mod m). Этот метод отличается от remainder в этом это всегда возвращает неотрицательный BigInteger.
    
    Параметры:
    m - модуль.
    
    Возвраты:
    this mod m
    
    Броски:
    
    ArithmeticException - m ≤ 0
    См. Также:
    remainder(java.math.BigInteger)
  - modPow
```
public BigInteger modPow(BigInteger exponent,
                BigInteger m)
```
    Возвращает BigInteger, значением которого является ^{(thisexponent mod m)}. (В отличие от этого pow, этот метод разрешает отрицательные экспоненты.)
    
    Параметры:
    exponent - экспонента.
    m - модуль.
    
    Возвраты:
    ^{thisexponent mod m}
    
    Броски:
    
    ArithmeticException - m ≤ 0 или экспонента отрицательно, и этот BigInteger не является относительно главным к m.
    См. Также:
    modInverse(java.math.BigInteger)
  - modInverse
```
public BigInteger modInverse(BigInteger m)
```
    Возвращает BigInteger, значение которого (this^-1 mod m).
    
    Параметры:
    m - модуль.
    
    Возвраты:
    this^-1 mod m.
    
    Броски:
    
    ArithmeticException - m ≤ 0, или этот BigInteger не имеет никакого модника мультипликативной инверсии м. (то есть, этот BigInteger не является относительно главным к m).
  - shiftLeft
```
public BigInteger shiftLeft(int n)
```
    Возвращает BigInteger, значение которого (this << n). Расстояние сдвига, n, может быть отрицательным, когда этот метод выполняет сдвиг вправо. (Вычисляет ^{floor(this * 2n)}.)
    
    Параметры:
    n - расстояние сдвига, в битах.
    
    Возвраты:
    this << n
    
    Броски:
    
    ArithmeticException - если расстояние сдвига Integer.MIN_VALUE.
    См. Также:
    shiftRight(int)
  - shiftRight
```
public BigInteger shiftRight(int n)
```
    Возвращает BigInteger, значение которого (this >> n). Расширение знака выполняется. Расстояние сдвига, n, может быть отрицательным, когда этот метод выполняет сдвиг влево. (Вычисляет ^{floor(this / 2n)}.)
    
    Параметры:
    n - расстояние сдвига, в битах.
    
    Возвраты:
    this >> n
    
    Броски:
    
    ArithmeticException - если расстояние сдвига Integer.MIN_VALUE.
    См. Также:
    shiftLeft(int)
  - и
```
public BigInteger and(BigInteger val)
```
    Возвращает BigInteger, значение которого (this & val). (Этот метод возвращает отрицательный BigInteger, если и только если это и val оба отрицательны.)
    
    Параметры:
    val - значение, чтобы быть AND'ed с этим BigInteger.
    
    Возвраты:
    this & val
  - или
```
public BigInteger or(BigInteger val)
```
    Возвращает BigInteger, значение которого (this | val). (Этот метод возвращает отрицательный BigInteger, если и только если или это или val отрицательны.)
    
    Параметры:
    val - значение, чтобы быть OR'ed с этим BigInteger.
    
    Возвраты:
    this | val
  - xor
```
public BigInteger xor(BigInteger val)
```
    Возвращает BigInteger, значение которого (this ^ val). (Этот метод возвращает отрицательный BigInteger, если и только если точно одно из этого и val отрицательно.)
    
    Параметры:
    val - значение, чтобы быть XOR'ed с этим BigInteger.
    
    Возвраты:
    this ^ val
  - нет
```
public BigInteger not()
```
    Возвращает BigInteger, значение которого (~this). (Этот метод возвращает отрицательную величину, если и только если этот BigInteger является неотрицательным.)
    
    Возвраты:
    ~this
  - andNot
```
public BigInteger andNot(BigInteger val)
```
    Возвращает BigInteger, значение которого (this & ~val). Этот метод, который эквивалентен and(val.not()), обеспечивается как удобство для того, чтобы замаскировал операции. (Этот метод возвращает отрицательный BigInteger если и только если this отрицательно и val положительно.)
    
    Параметры:
    val - значение, которое будет дополнено и AND'ed этим 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, если этот BigInteger никого не содержит биты. (Вычисляет (this==0? -1 : log2(this & -this)).)
    
    Возвраты:
    индекс самого правого одного бита в этом BigInteger.
  - bitLength
```
public int bitLength()
```
    Возвращает число битов в минимальном two's-дополнительном представлении этого BigInteger, исключая знаковый бит. Для положительного BigIntegers это эквивалентно числу битов в обычном двоичном представлении. (Вычисляет (ceil(log2(this < 0 ? -this : this+1))).)
    
    Возвраты:
    число битов в минимальном two's-дополнительном представлении этого BigInteger, исключая знаковый бит.
  - число битов
```
public int bitCount()
```
    Возвращает число битов в дополнительном представлении two этого BigInteger, которые отличаются от его знакового бита. Этот метод полезен, реализовывая наборы стиля битовый вектора на BigIntegers.
    
    Возвраты:
    число битов в дополнительном представлении two этого BigInteger, которые отличаются от его знакового бита.
  - isProbablePrime
```
public boolean isProbablePrime(int certainty)
```
    Возвраты true если этот BigInteger является, вероятно, главным, false если это - определенно составной объект. Если certainty ≤ 0, true возвращается.
    
    Параметры:
    certainty - мера неопределенности, которую вызывающая сторона готова терпеть: если вызов возвращается true вероятность, что этот BigInteger является главным, превышает (1 - 1/2^certainty). Время выполнения этого метода пропорционально значению этого параметра.
    
    Возвраты:
    true если этот BigInteger является, вероятно, главным, false если это - определенно составной объект.
  - compareTo
```
public int compareTo(BigInteger val)
```
    Сравнивает этот BigInteger с указанным BigInteger. Этот метод обеспечивается в предпочтении к отдельным методам для каждого из шести булевых операторов сравнения (<, ==,>,> =! =, <=). Предложенная идиома для того, чтобы выполнить эти сравнения: (x.compareTo(y) <op> 0), где <op> является одним из этих шести операторов сравнения.
    
    Определенный:
    
    compareTo в интерфейсе Comparable<BigInteger>
    
    Параметры:
    val - BigInteger, с которым должен быть сравнен этот BigInteger.
    
    Возвраты:
    -1, 0 или 1, поскольку этот BigInteger является в цифровой форме меньше чем, равный, или больше чем val.
  - равняется
```
public boolean equals(Object x)
```
    Сравнивает этот BigInteger с указанным Объектом для равенства.
    
    Переопределения:
    
    equals в классе Object
    
    Параметры:
    x - Объект, с которым должен быть сравнен этот BigInteger.
    
    Возвраты:
    true если и только если указанным Объектом является BigInteger, значение которого в цифровой форме равно этому BigInteger.
    См. Также:
    Object.hashCode(), HashMap
  - минута
```
public BigInteger min(BigInteger val)
```
    Возвращает минимум этого BigInteger и val.
    
    Параметры:
    val - значение, с которым должен быть вычислен минимум.
    
    Возвраты:
    BigInteger, значение которого является меньшим из этого BigInteger и val. Если они равны, любой может быть возвращен.
  - максимальный
```
public BigInteger max(BigInteger val)
```
    Возвращает максимум этого BigInteger и val.
    
    Параметры:
    val - значение, с которым должен быть вычислен максимум.
    
    Возвраты:
    BigInteger, значение которого является большим из этого и val. Если они равны, любой может быть возвращен.
  - хэш-код
```
public int hashCode()
```
    Возвращает хэш-код для этого BigInteger.
    
    Переопределения:
    
    hashCode в классе Object
    
    Возвраты:
    хэш-код для этого BigInteger.
    См. Также:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)
  - toString
```
public String toString(int radix)
```
    Возвращает Строковое представление этого BigInteger в данном основании. Если основание вне диапазона от Character.MIN_RADIX к Character.MAX_RADIX включительно, это примет значение по умолчанию к 10 (как имеет место для Integer.toString). Отображение цифры-к-символьному, обеспеченное Character.forDigit используется, и знак "минус" предварительно ожидается если приспособлено. (Это представление является совместимым с (String, int) конструктор.)
    
    Параметры:
    radix - основание Строкового представления.
    
    Возвраты:
    Строковое представление этого BigInteger в данном основании.
    См. Также:
    Integer.toString(int, int), Character.forDigit(int, int), BigInteger(java.lang.String, int)
  - toString
```
public String toString()
```
    Возвращает десятичное Строковое представление этого BigInteger. Отображение цифры-к-символьному, обеспеченное Character.forDigit используется, и знак "минус" предварительно ожидается если приспособлено. (Это представление является совместимым с (String) конструктор, и учитывает Конкатенацию строк с Java + оператор.)
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    десятичное Строковое представление этого BigInteger.
    См. Также:
    Character.forDigit(int, int), BigInteger(java.lang.String)
  - toByteArray
```
public byte[] toByteArray()
```
    Возвращает байтовый массив, содержащий two's-дополнительное представление этого BigInteger. Байтовый массив будет в порядке байтов с обратным порядком байтов: старший значащий байт в своей стихии. Массив будет содержать минимальное число байтов, требуемых представлять этот BigInteger, включая по крайней мере один знаковый бит, который является (ceil((this.bitLength() + 1)/8)). (Это представление является совместимым с (byte[]) конструктор.)
    
    Возвраты:
    байтовый массив, содержащий two's-дополнительное представление этого BigInteger.
    См. Также:
    BigInteger(byte[])
  - intValue
```
public int intValue()
```
    Преобразовывает этот BigInteger в int. Это преобразование походит на сужающееся примитивное преобразование из long к int как определено в разделе 5.1.3 из Спецификации языка Java™: если этот BigInteger является слишком крупным, чтобы вписаться int, только младший разряд 32 бита возвращается. Отметьте, что это преобразование может потерять информацию о полной величине значения BigInteger так же как возвратить результат с противоположным знаком.
    
    Определенный:
    
    intValue в классе Number
    
    Возвраты:
    этот BigInteger преобразовал в int.
  - longValue
```
public long longValue()
```
    Преобразовывает этот BigInteger в a long. Это преобразование походит на сужающееся примитивное преобразование из long к int как определено в разделе 5.1.3 из Спецификации языка Java™: если этот BigInteger является слишком крупным, чтобы поместиться в a long, только младший разряд 64 бита возвращается. Отметьте, что это преобразование может потерять информацию о полной величине значения BigInteger так же как возвратить результат с противоположным знаком.
    
    Определенный:
    
    longValue в классе Number
    
    Возвраты:
    этот BigInteger преобразовал в a long.
  - floatValue
```
public float floatValue()
```
    Преобразовывает этот BigInteger в a float. Это преобразование подобно сужающемуся примитивному преобразованию из double к float как определено в разделе 5.1.3 из Спецификации языка Java™: если у этого BigInteger есть слишком большая величина, чтобы представить как a float, это будет преобразовано в Float.NEGATIVE_INFINITY или Float.POSITIVE_INFINITY как соответствующий. Отметьте, что, даже когда возвращаемое значение конечно, это преобразование может потерять информацию о точности значения BigInteger.
    
    Определенный:
    
    floatValue в классе Number
    
    Возвраты:
    этот BigInteger преобразовал в a float.
  - doubleValue
```
public double doubleValue()
```
    Преобразовывает этот BigInteger в a double. Это преобразование подобно сужающемуся примитивному преобразованию из double к float как определено в разделе 5.1.3 из Спецификации языка Java™: если у этого BigInteger есть слишком большая величина, чтобы представить как a double, это будет преобразовано в Double.NEGATIVE_INFINITY или Double.POSITIVE_INFINITY как соответствующий. Отметьте, что, даже когда возвращаемое значение конечно, это преобразование может потерять информацию о точности значения BigInteger.
    
    Определенный:
    
    doubleValue в классе Number
    
    Возвраты:
    этот BigInteger преобразовал в a double.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс BigInteger

Полевая Сводка

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Число

Методы java.lang унаследованный от класса. Объект

Полевая Деталь

НУЛЬ

ОДИН

ДЕСЯТЬ

Деталь конструктора

BigInteger

BigInteger

BigInteger

BigInteger

BigInteger

BigInteger

Деталь метода

probablePrime

nextProbablePrime

valueOf

добавить

вычесть

умножиться

разделиться

divideAndRemainder

остаток

голова

НОД

abs

инвертировать

знак

модник

modPow

modInverse

shiftLeft

shiftRight

и

или

xor

нет

andNot

testBit

setBit

clearBit

flipBit

getLowestSetBit

bitLength

число битов

isProbablePrime

compareTo

равняется

минута

максимальный

хэш-код

toString

toString

toByteArray

intValue

longValue

floatValue

doubleValue