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

gmp_initCria um número GMP


gmp_init(mixed $number, int $base = ?): resource

Cria um número GMP a partir de um inteiro ou uma string.



Um inteiro ou uma string. A string pode representar um decimal, hexadecimal ou octal.


A base. O padrão é 0.

A base pode varia de 2 a 36. Se a base for 0 (valor padrão), a base atual é determinada pelos caracteres que vem na frente. Se os dois primeiros caracteres forem 0x ou 0X, é assumido hexadecimal, se não o primeiro caractere for "0", é assumido como octal, se não é assumido como decimal.

Valor Retornado

Um número GMP resource no PHP 5.5 e anteriores, ou um objeto GMP do PHP 5.6 em diante.


Exemplo #1 Criando um número GMP

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



Não é necessário utilizar esta função se você quer usar um inteiro ou uma string no lugar de um número GMP nas funções GMP, como gmp_add(). Argumentos das funções são automaticamente convertidos para números GMP, se esta conversão é possível e necessária, usando as mesmas regras que gmp_init().

add a note

User Contributed Notes 7 notes

php at richardneill dot org
16 years ago
Here's a way to parse a decimal (eg 3.25) into an integer and exponent:

if (preg_match("/^[0-9]+\.[0-9]+$/",$input)){
     //Input is a base-10 decimal. Multiply as necessary to remove the decimal
     //point. Convert that to a gmp_resource, then decrement the exponent
     //to compensate.

     $pieces=explode(".", $input);     //Split at the d.p.
     $input="$pieces[0]$pieces[1]";  //Remove the decimal point.

     //Remove any leading zeros, or gmp_init will parse the number as octal.

     if ($input==''){    //Deal with "0.0" which would otherwise be ''.
     //exponent = (-)  the number of characters after the decimal point.
karl dot debisschop at pearson dot com
11 years ago
Unless the base is 16, gpm_init will fail if the string begins with "0b".

> php -r '$v = gmp_init("b83", 17); print("$v\n");'

Resource id #4

> php -r '$v = gmp_init("0b83", 17); print("$v\n");'

[nothing prints]

In may case, where I am explicitly specifying the base, the solution is to apply ltrim first:

> php -r '$v = gmp_init(ltrim("0b83", "0"), 17); print("$v\n");'

Resource id #4
marcus at synchromedia dot co dot uk
11 years ago
I discovered that the gmp functions use [0-9a-f] up to base 16, but [0-9A-Za-z] (i.e. upper case first) from bases 17 to 62. This differs from most of the base-62 implementations I've found that tend to use lower case first.
php at richardneill dot org
16 years ago
Note: Leading zeros will make gmp_init parse this as octal.
Thus gmp_init(010) becomes 8. 

$a=010;              //8
$b="010" + 0;     //10
$c=gmp_strval(gmp_init(010));    //8
$d=gmp_strval(gmp_init("010")); //8

This behaviour is inconsistent: either $d should equal $b, or
$b should equal $a.
Aurelien Marchand
8 months ago
Missing from the documentation: gmp_init() return false in case it failed to parse $num

// returns "bool(false)" and not a GMP object as hinted by the documentation, it also triggers a Warning "PHP Warning:  gmp_init(): Unable to convert variable to GMP - string is not an integer in php shell code on line 1"

charlie at oblivion dot cz
15 years ago
gmp_* functions don't accept strings with a leading '+':
echo gmp_strval(gmp_init('+42'));      #0
echo gmp_strval(gmp_add('42', '+42')); #42
echo bcadd('+42', '+42');              #84
thomas dot hebinck at digionline dot de
17 years ago
If you call a gmp_* function directly with an interger as parameter, this integer MUST NOT be 0:

for($i=-1;$i<=1;$i++) {  echo gmp_strval(gmp_add(2,gmp_mul(1,$i))) . ' ';  }

The result is 1 0 3 (wrong)

In this case you have to use gmp_init():

for($i=-1;$i<=1;$i++) {  echo gmp_strval(gmp_add(2,gmp_mul(1,gmp_init($i)))) . ' ';  }

The result is 1 2 3 (right)

Happy number crunching! :-)
To Top