Класс java.math.BigInteger предоставляет операции, аналогичные всем примитивным целочисленным операторам Java и всем соответствующим методам из java.lang.Math.
Он также предоставляет операции для модульной арифметики, вычисления GCD, тестирования простоты, генерации простых чисел, манипуляции битами и некоторых других различных операций. Все операции ведут себя так, как если бы BigIntegers были представлены в виде двоичного дополнения.
Семантика арифметических операций и побитовых логических операций аналогична таковым у целочисленных арифметических операторов Java и побитовых целочисленных операторов Java соответственно. Семантика операций сдвига расширяет семантику операторов сдвига Java, чтобы учесть отрицательные расстояния сдвига.
Операции сравнения выполняют целочисленные сравнения со знаком. Модульные арифметические операции предоставляются для вычисления вычетов, возведения в степень и вычисления мультипликативных инверсий. Битовые операции работают с одним битом представления двух дополняющих их операнда.
Все методы и конструкторы в этом классе генерируют исключение NullPointerException при передаче пустой ссылки на объект для любого входного параметра.
Объявление класса
Ниже приводится объявление для класса java.math.BigInteger —
public class BigInteger
extends Number
implements Comparable<BigInteger>
поле
Ниже приведены поля для класса java.math.BigInteger —
статический BigInteger ONE — константа BigInteger одна.
статический BigInteger TEN — константа BigInteger десять.
статический BigInteger ZERO — константа BigInteger ноль.
BigInteger (byte [] val)
Этот конструктор используется для преобразования байтового массива, содержащего двоичное представление BigInteger с дополнением до двух, в BigInteger.
BigInteger (int signum, байтовая [] величина)
Этот конструктор используется для перевода значения знака BigInteger в BigInteger.
BigInteger (int bitLength, int безусловно, случайный rnd)
Этот конструктор используется для создания случайно сгенерированного положительного BigInteger, который, вероятно, является простым, с указанным bitLength.
BigInteger (int numBits, Случайный rnd)
Этот конструктор используется для создания случайно сгенерированного BigInteger, равномерно распределенного в диапазоне от 0 до (2 numBits — 1) включительно.
BigInteger (Струнный вал)
Этот конструктор используется для перевода десятичного строкового представления BigInteger в BigInteger.
BigInteger (String val, int radix)
Этот конструктор используется для преобразования строкового представления BigInteger с заданным основанием в BigInteger.
Этот метод возвращает BigInteger, значение которого является абсолютным значением этого BigInteger.
Этот метод возвращает BigInteger со значением (this + val).
Этот метод возвращает BigInteger со значением (this & val).
Этот метод возвращает BigInteger со значением (this & ~ val).
Этот метод возвращает количество битов в двоичном представлении этого BigInteger, которые отличаются от его знакового бита.
Этот метод возвращает число битов в минимальном представлении BigInteger с двумя дополнительными символами, исключая знаковый бит.
Этот метод возвращает BigInteger, значение которого эквивалентно этому BigInteger с очищенным назначенным битом.
Этот метод сравнивает этот BigInteger с указанным BigInteger.
Этот метод возвращает BigInteger со значением (this / val).
Этот метод возвращает массив из двух BigInteger, содержащий (this / val), за которым следует (this% val).
Этот метод преобразует этот BigInteger в двойной.
Этот метод сравнивает этот BigInteger с указанным объектом на равенство.
Этот метод возвращает BigInteger, значение которого эквивалентно этому BigInteger с перевернутым назначенным битом.
Этот метод преобразует этот BigInteger в число с плавающей точкой.
Этот метод возвращает BigInteger, значение которого является наибольшим общим делителем abs (this) и abs (val).
Этот метод возвращает индекс самого правого (самого младшего) одного бита в этом BigInteger (число нулевых битов справа от самого правого одного бита).
Этот метод возвращает хеш-код для этого BigInteger.
Этот метод преобразует этот BigInteger в int.
Этот метод возвращает true, если этот BigInteger, вероятно, является простым, false, если он определенно составной.
Этот метод преобразует этот BigInteger в long.
Этот метод возвращает максимум этого BigInteger и val.
Этот метод возвращает минимум этого BigInteger и val.
Этот метод возвращает BigInteger со значением (этот мод m).
Этот метод возвращает BigInteger, значение которого (это -1 mod m).
Этот метод возвращает BigInteger, значение которого равно (это показатель степени m).
Этот метод возвращает BigInteger, значение которого (this * val).
Этот метод возвращает BigInteger со значением (-this).
Этот метод возвращает первое целое число больше, чем этот BigInteger, который, вероятно, является простым.
Этот метод возвращает BigInteger со значением (~ this).
Этот метод возвращает BigInteger со значением (this | val).
Этот метод возвращает BigInteger, значение которого (это показатель степени ).
Этот метод возвращает положительное значение BigInteger, которое, вероятно, является простым, с указанным bitLength.
Этот метод возвращает BigInteger, значение которого (это% val).
Этот метод возвращает BigInteger, значение которого эквивалентно этому BigInteger с установленным назначенным битом.
Этот метод возвращает BigInteger, значение которого (this << n).
Этот метод возвращает BigInteger со значением (this >> n).
Этот метод возвращает функцию signum этого BigInteger.
Этот метод возвращает BigInteger, значение которого (this — val).
Этот метод возвращает истину тогда и только тогда, когда установлен назначенный бит.
Этот метод возвращает байтовый массив, содержащий двоичное представление этого BigInteger.
Этот метод возвращает десятичное строковое представление этого BigInteger.
Этот метод возвращает строковое представление этого BigInteger в данном основании.
Этот метод возвращает BigInteger, значение которого равно значению указанного long.
Этот метод возвращает BigInteger, значение которого (this ^ val).