gmp_init

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

gmp_init — Создаёт GMP-число

Описание

gmp_init(int|string $num, int $base = 0): GMP

Функция создаёт GMP-число из целого числа или строки.

Список параметров

num
Целое число или строка. Параметр принимает строковое представление аргумента в десятичной, шестнадцатеричной, восьмеричной или двоичной нотации.
base
Основание для преобразования представления числа при передаче в первый параметр значения с типом string. Параметр принимает основания в закрытом интервале между 2 и 62. Параметр игнорирует регистр числа для оснований до 36 включительно; строчные и заглавные буквы эквивалентны. Для оснований от 37 до 62 буквы в верхнем регистре представляют значения от 10 до 35, а в нижнем — от 36 до 61. Функция определяет основание по начальным символам аргумента num, если основание base равно 0. Строка интерпретируется как шестнадцатеричное число, если первые два символа равны 0x или 0X. Строка интерпретируется как двоичное число, если первые два символа числа равны 0b или 0B. Строка интерпретируется как восьмеричное число, если первые два символа равны 0o или 0o. Больше того, если первый символ в первом аргументе равен 0, строка тоже интерпретируется как восьмеричное число. В остальных случаях строка интерпретируется как десятичное целочисленное значение.

Возвращаемые значения

Объект класса GMP.

Список изменений

Версия Описание
8.1.0 Для строковых аргументов num добавили поддержку явных восьмеричных префиксов 0o и 0o. Интерпретацию таких префиксов, когда значение основания base равно 0, тоже добавили.

Примеры

Пример #1 Пример создания GMP-числа

<?php

$a = gmp_init(123456);
$b = gmp_init("0xFFFFDEBACDFEDF7200");

?>

Примечания

Замечание:

Не обязательно вызывать функцию при передаче вместо GMP-числа целочисленного значения или строки в GMP-функции наподобие функции gmp_add(). Аргументы функций автоматически преобразуются в GMP-числа по правилам функции gmp_init(), если такое преобразование требуется и возможно.

Смотрите также