Математические функции GMP
Эти функции позволяют работать с целыми числами повышенной точности определенного формата, используя библиотеку GNU MP. Для использования их в РЫР необходимо перекомпилировать его с ключом — with-gmp.
Коды библиотеки и документацию можно загрузить с сайта http:// www.swox.com/gmp/. Требуется версия 2 или выше.
Эти функции (их большинство) могут также работать с обычными целочисленными и строковыми (содержащими целые числа) аргументами, которые автоматически преобразуются в формат GMP. Но наивысшая производительность все же достигается при непосредственном использовании чисел формата GMP; см. также gmp_init().
<'php function fact ($x) { // функция вычисления факториала if ($x <= 1) // (достаточно быстро вычисляет return 1; // факториалы до 1000) else return gmpjnul ($x. Tact ($x-D); } print gmp_strval (fact (1000)) "\n": ?>
Значения чисел GMP
gmpjnit
Создание числа GMP
resource gmp_init (mixed number)
Число GMP создается из целочисленного или строкового аргумента. В строке число может быть указано в десятичном или шестнадцате-ричном (тогда оно должно иметь префикс Ох) формате.
$а - gmp init (123456); $b - grapjrvtt ("OxFFFFDEBACDFEDF7200");
Заметьте, не всегда необходимо явно вызывать эту функцию, если нужно использовать в функциях GMP (например, gmp_add()) обычные числа или строки вместо чисел GMP. Аргументы функций GMP автоматически конвертируются при необходимости (и возможности) с использованием тех же правил, что и для функции gmp_init().
gmp_intval
Конвертация числа GMP в целое
int gmp_intval(resource gmpnumber)
Возвращает целое число, если оно не превышает его максимально возможную размерность (тип знакового длинного (32 бита) — signed long type). Если необходимо всего лишь распечатать значение, используйте gmp_strval().
gmp_strval
Конвертация числа GMP в строку
string gmp_strval (resource gmpnumber [, int base])
Возвращает строковое представление числа GMP в системе счисления base (по умолчанию, в десятичной). Возможные системы счисления — от 2 до 36.
gmp_ abs
Получение абсолютного значения числа
resource gmp_abs (resource a)
Возвращает абсолютное ( то есть неотрицательное) значение числа.
gmp_sign
Получение знака числа
int gmp_sign (resource a)
Возвращает 1, если число положительное, или -1, если число отрицательное.
gmp_neg
Получение отрицательного значения числа
resource gmp_neg (resource a) Возвращает (-а).
Арифметика
gmp_add
Сложение
resource gmp_add (resource a, resource b)
Возвращает GMP число - сумму аргументов а и b.
gmp_sub
Вычитание
resource gmp_sub (resource a, resource b)
Возвращает GMP число - разность (a-b).
gmp_mul
Умножение
resource gmp_mul (resource a. resource b)
Возвращает GMP число - произведение аргументов а и b.
gmp_div
Синоним функции gmp_div_q
resource gmp_div (resource a, resource b [, int round])
gmp _div_q
Деление
resource gmp_div_q (resource a, resource b)
Возвращает результат деления а на b. Результат округляется в зависимости от указанного аргумента:
Имеется синоним функции - gmp_div().
См. также: gmp_div_r(), gmp_div_qr().
gmp_div_r
Получение остатка целочисленного деления
resource gn,p_div_r (resource n, resource d [. int round])
Функция сходна с gmp_div_q(). Остаток будет иметь знак аргумента n.
См. также: gmp_div_q(), gmp_div_qr().
gmp_div_qr
Деление с остатком
array gmp_div_qr (resource n, resource d [, int round])
Функция комбинирует действие функций gmp_div_q() и gmp_div_r() и возвращает массив, в котором элемент [0] — целое частное, а [1] - остаток.
$а = gmpjimt ("Ox41682I79fbf5"). $res = gmp_chv_qr ($a. "OxDEFE75"); pnntf( "Результат: частное» *s. остаток= %s". gmp_strval ($res[0]). gmp_strval ($res[l])):
См. также: gmp_div_q(), gmp_div_r().
gmp_mod
Получение абсолютного остатка деления
resource gmpjnod (resource n, resource d)
Функция эквивалентна gmp_div_r(), знак результата которой отбрасывается.
gmp_ divexact
Безостаточное деление
resource gmp_divexact (resource n, resource d)
Так как функция использует алгоритм «точного» деления, результат будет достоверным, только если заранее известно, что d нацело делит n.
gmp_cmp
Сравнение
int gmp_cmp (resource a, resource b)
Возвращает положительное значение, если а > b; ноль, если а = b; и отрицательное значение, если а < b.
Математика
gmp_fact
Вычисление факториала
resource gmp_fact (int a)
gmp_sqrt
Вычисление квадратного корня
resource gmp_sqrt (resource a)
gmp_sqrtrm
Вычисление квадратного корня с остатком
array gmp_sqrtrm (resource a)
Возвращает массив, в котором элемент [0] — целый квадратный корень аргумента (который также возвращается функцией gmp_sqrt()), а элемент [1] — разность между аргументом и элементом [0] в квадрате.
gmp_perfect_square
Определение, является ли число полным квадратом
bool gmp_perfect_squar~e (resource a)
Возвращает TRUE, если а является квадратом целого числа, иначе, FALSE.
См. также: gmp_sqrt(), gmp_sqrtrm().
gmp_pow
Возведение числа в степень
resource gmp_pow (resource base, int exp)
Возвращает результат возведения основания base в степень exp. Для аргументов (0,0) возвращается 1. ехр не должен быть отрицательным.
gmp_powm
Получение остатка деления степени числа
resource gmp_powm (resource base, resource exp, resource mod)
Возвращает результат: остаток от деления (основание base, возведенное в степень ехр) на mod. При отрицательном ехр результат не определен.
gmp_prob_prime
Проверка «вероятно» простого числа
int gmp_prob_pnme (resource a [, Int reps])
Функция возвращает 0, если а сложное число (имеющее более двух целых делителей). Если возвращается 1, то а, возможно, простое число. Если возвращается 2, то тогда а, без сомнения, простое число. Возможные значения аргумента reps: от 5 до 10 (по умолчанию 10) определяют качество проверки (чем больше это число, тем выше достоверность результата, то есть непринятия сложного числа за вероятно-простое).
Функция использует алгоритм вероятностного теста Мпллера-Рабина (Miller-Rabin).
gmp_ gcd
Нахождение наибольшего общего делителя
resource gmp_gcd (resource a, resource b) Возвращает всегда положительный результат.
gmp_ gcdext
Нахождение наибольшего общего делителя со множителями
array gmp_gcdext (resource a, resource b)
Возвращает в массиве значения g, s, t, такие, что a*s + b*t = g = НОД(а.b), где НОД — наибольший общий делитель.
gmp_invert
Инверсия по модулю
resource gmp_invert (resource a, resource b)
Возвращает дополнение а до значения, делящегося нацело на b. Возвращает FALSE, если результат не может быть найден.
gmp_ legendre
Получение числа Лежандра
int gmpjegendre (resource a, resource p)
Возвращает число Лежандра (Legendre symbol), р должно быть четным положительным.
gmp_jacobi
Получение числа Якоби
int gmpjacobi (resource a, resource p)
Возвращает число Якоби (Jacob! symbol), p должно быть четным положительным.
gmp_random
Генерация случайного числа
resource grap_random (int limiter)
limiter указывает длину генерируемого числа (если значение отрицательное, генерируется отрицательное число).
gmp_popcount
Получение популяции
int gmp_popcount (resource a)
Возвращает числитель популяции.
gmp_ hamdist
Вычисление дистанции
int gmp_hamdist (resource a, resource b)
Возвращает дистанцию (hamming) между а и b. Оба аргумента должны быть неотрицательными.
Бинарные операции
gmp_ and
Логическое И (AND)
resource gmp_and (resource a, resource b)
gmp_or
Логическое ИЛИ (OR)
resource gmp_or (resource a, resource Из)
gmp_xor
Логическое исключающее ИЛИ (XOR) resource gmp_xor (resource a. resource b)
gmp_setbit
Установка бита
resource gmp_setbit (resource &a, int index [, bool set_clear])
Устанавливает бит в позиции index в числе а. Аргумент set_clear указывает, в какое значение устанавливать бит: 0 или 1 (по умолчанию, в 1).
gmp_ clrbit
Сброс бита
resource gmp_c!rbit (resource &a, int index) Устанавливает бит в позиции index в числе а в значение 0.
gmp_scan0
Поиск бита 0
Oint grap_scanO (resource a, int start)
Ищет в числе а бит 0, начиная с позиции start, в сторону увеличения значимости разрядов. Возвращает позицию найденного бита.
gmp_scan1
Поиск бита 1
lint gmp_scanl (resource a, int start)
Ищет в числе а бит 1, начиная с позиции start, в сторону увеличения значимости разрядов. Возвращает позицию найденного бита.
