XLVI. Funciones GMP

IntroducciÃ³n

Estas funciones permiten trabajar con nÃºmeros enteros de cualquier longitud arbitraria empleando la librerÃ GNUMP.

Estas funciones se aÃ±adieron en la versiÃ³n de PHP 4.0.4.

Nota: La mayorÃa de funciones GMP aceptan como argumentos nÃºmeros GMP, definidos como resource mÃ¡s adelante. Sin embargo, la mayorÃa de estas funciones tambiÃ©n aceptan argumentos de tipo numÃ©rico o cadenas de texto, ya que se pueden convertir fÃ¡cilmente. AdemÃ¡s, si existe una funciÃ³n mÃ¡s rÃ¡pida que pueda operar con enteros, se emplearÃ¡ esa funciÃ³n en lugar de la otra funciÃ³n mÃ¡s lenta. Este proceso se realiza de forma automÃ¡tica y transparente, por lo que a modo de resumen se puede decir que se pueden emplear nÃºmeros de tipo entero en todas aquellas funciones cuyos parÃ¡metros se han definido como nÃºmeros GMP. Vea tambiÃ©n la documentaciÃ³n de la funciÃ³n gmp_init().

Aviso

Si se quiere indicar de forma explÃcita un nÃºmero entero muy grande, se recomienda hacerlo en forma de cadena. De otra forma, PHP lo interpreta como un entero y podrÃa producirse una pÃ©rdida de precisiÃ³n antes de comenzar a utilizar las funciones GMP.

Nota: Esta extensiÃ³n estÃ¡ disponible en sistemas Windows desde la versiÃ³n de PHP 5.1.0.

Requisitos

La librerÃa GMP de puede descargar desde la direcciÃ³n http://www.swox.com/gmp/. AdemÃ¡s, en ese sitio web tambiÃ©n estÃ¡ disponible el manual de GMP.

Para poder utilizar estas funciones se requiere al menos la versiÃ³n 2 de GMP. Algunas funciones pueden requerir ademÃ¡s alguna versiÃ³n mÃ¡s reciente.

InstalaciÃ³n

Para poder utilizar estas funciones, se debe compilar PHP con soporte de GMP mediante la opciÃ³n --with-gmp.

ConfiguraciÃ³n en tiempo de ejecuciÃ³n

Esta extensiÃ³n no tiene directivas de configuraciÃ³n en php.ini.

Tipos de recursos

Esta extensiÃ³n no tiene ningÃºn tipo de recurso definido.

Constantes predefinidas

Estas constantes estÃ¡n definidas por esta extensiÃ³n y estarÃ¡n disponibles solamente cuando la extensiÃ³n ha sido o bien compilada dentro de PHP o grabada dinÃ¡micamente en tiempo de ejecuciÃ³n.

GMP_ROUND_ZERO (integer)
GMP_ROUND_PLUSINF (integer)
GMP_ROUND_MINUSINF (integer)

Ejemplos

Ejemplo 1. CÃ¡lculo del factorial usando GMP

<?php function fact($x) { $factorial = 1; for ($i=2; $i < $x; $i++) { $factorial = gmp_mul($factorial, $i); } return $factorial; } echo gmp_strval(fact(1000)) . "\n"; ?>

En el ejemplo se calcula el factorial de nÃºmero 1000 (un nÃºmero bastante grande para calcular su factorial) de forma bastante rÃ¡pida.

Ver tambiÃ©n

Se pueden encontrar muchas otras funciones matemÃ¡ticas en las secciones Funciones matemÃ¡ticas de precisiÃ³n arbitraria BCMath y Funciones MatemÃ¡ticas.

Tabla de contenidos
gmp_abs -- Valor absoluto
gmp_add -- Suma nÃºmeros
gmp_and -- Realiza una operaciÃ³n de AND lÃ³gico
gmp_clrbit -- Borra un bit
gmp_cmp -- Compara nÃºmeros
gmp_com -- Calcula el complementario
gmp_div_q -- Divide nÃºmeros
gmp_div_qr -- Divide nÃºmeros y obtiene el cociente y el resto
gmp_div_r -- Resto de la divisiÃ³n de nÃºmeros
gmp_div -- Alias of gmp_div_q()
gmp_divexact -- DivisiÃ³n exacta de nÃºmeros
gmp_fact -- Factorial
gmp_gcd -- Calcula el MCD (mÃ¡ximo comÃºn divisor)
gmp_gcdext -- Calcula el MCD y los coeficientes
gmp_hamdist -- Distancia de Hamming
gmp_init -- Crea un nÃºmero GMP
gmp_intval -- Convierte nÃºmeros GMP a nÃºmeros enteros
gmp_invert -- Invierte segÃºn el mÃ³dulo
gmp_jacobi -- Calcula el sÃmbolo de Jacobi
gmp_legendre -- Calcula el sÃmbolo de Legendre
gmp_mod -- OperaciÃ³n MÃ³dulo
gmp_mul -- Multiplica nÃºmeros
gmp_neg -- Cambia el signo de un nÃºmero
gmp_or -- Realiza una operaciÃ³n de OR lÃ³gico
gmp_perfect_square -- Comprueba si es un cuadrado perfecto
gmp_popcount -- Calcula la poblaciÃ³n de un nÃºmero
gmp_pow -- Eleva un nÃºmero a una potencia
gmp_powm -- Eleva un nÃºmero a una potencia segÃºn el mÃ³dulo
gmp_prob_prime -- Comprueba si un nÃºmero tiene probabilidades de ser un nÃºmero primo
gmp_random -- Genera un nÃºmero aleatorio
gmp_scan0 -- Busca un 0
gmp_scan1 -- Busca un 1
gmp_setbit -- Establece el valor de un bit
gmp_sign -- Obtiene el signo del nÃºmero
gmp_sqrt -- Calcula la raÃz cuadrada
gmp_sqrtrem -- Calcula la raÃz cuadrada con el resto
gmp_strval -- Convierte un nÃºmero GMP a una cadena de texto
gmp_sub -- Resta nÃºmeros
gmp_xor -- Realiza una operaciÃ³n de XOR lÃ³gico

add a note User Contributed Notes
Funciones GMP

john at worldmapad dot com
22-Jul-2006 11:24


Here's a quick and dirty way to use simple GMP functions with PHP without recompiling. It is dependent upon the use of the exec() function, so make sure you can use exec(). While in safe mode you must consider the safe_mode_exec_dir directive. And don't simply pass user input to the exec function without validating the input first!



Download and Install GMP as instructed in README and INSTALL files.

On my MAC OS X Server, I just did the following:

./configure

make

make check

make install

This installed it in the /usr/local directory. There were some errors, but not with any functions I needed.

Within the gmp-4.#.# cd into the demos directory. Then compile pexpr.c by typing:

make pexpr

This is a simple expressions parser which serves as a simple interface to some of the basic GMP functions.

You can test it then like:

./pexpr "102394874783 * 23498748";

Now you may interface with it using PHP's exec() function.

richard-slater.co.uk
22-Feb-2004 01:03


For those (like me) who are trying to do bit masking with very large numbers, here is a useful function to do the work for you.



<?php

  function isBitSet($bitMask, $bitMap)

  {

    return (bool) gmp_intval(gmp_div(gmp_and($bitMask, $bitMap),$bitMask));

  }

?>

helvecio_oliveira at yahoo dot com dot br
15-Oct-2003 01:51


=============================================================

A set of very nice functions to handle IP Address with gmplib:



The best way to store a range into a database is store:

dNet ..... decimal representation of a Net

dMask .... decimal representation of a Mask



All another parameters can be calculated.



<?

/*

f_ip2dec($a) ................... IP string to decimal

f_dec2ip($a) ................... decimal to IP string



f_dec2ipall($dNet,$dMask) ...... decimal Net and Mask to an Array with several IP parameters



f_dec2cidr($a) ................. decimal Mask to CIDR



f_and($a,$b) ................... and

f_or($a,$b) .................... or

f_xor($a,$b) ................... xor

f_not($a) ...................... not

f_dec2bin($a) .................. decimal to binary string

f_bin2dec($a) .................. binary string to decimal

*/



function f_and($a,$b){

$a=gmp_init(strval($a));

$b=gmp_init(strval($b));

$d=gmp_and($a,$b);

return floatval(gmp_strval($d));

}



function f_or($a,$b){

$a=gmp_init(strval($a));

$b=gmp_init(strval($b));

$d=gmp_or($a,$b);

return floatval(gmp_strval($d));

}



function f_xor($a,$b){

$a=gmp_init(strval($a));

$b=gmp_init(strval($b));

$d=gmp_xor($a,$b);

return floatval(gmp_strval($d));

}



function f_not($a){

$a=gmp_init(strval($a));

$d=gmp_strval($a,2);

$d=str_replace("1","x",$d);

$d=str_replace("0","1",$d);

$d=str_replace("x","0",$d);

$d=gmp_init($d,2);

return floatval(gmp_strval($d,10));

}



function f_dec2bin($a){

$a=gmp_init(strval($a));

return gmp_strval($a,2);

}



function f_bin2dec($a){

$a=gmp_init(strval($a),2);

return floatval(gmp_strval($a,10));

}



function f_ip2dec($a){

$d = 0.0;

$b = explode(".", $a,4);

for ($i = 0; $i < 4; $i++) {

        $d *= 256.0;

        $d += $b[$i];

    };

return $d;

}



function f_dec2ip($a){

    $b=array(0,0,0,0);

    $c = 16777216.0;

    $a += 0.0;

    for ($i = 0; $i < 4; $i++) {

        $k = (int) ($a / $c);

        $a -= $c * $k;

        $b[$i]= $k;

        $c /=256.0;

    };

    $d=join('.', $b);

    return($d);

}



function f_dec2cidr($a){

$a=gmp_init(strval($a));

$d=strlen(str_replace("0","",gmp_strval($a,2)));

return $d;

}



function f_dec2ipall($dNet,$dMask){

  $dWildCard=f_not($dMask);

  $IpAll["Net"]=f_dec2ip($dNet);

  $IpAll["Mask"]=f_dec2ip($dMask);

  $IpAll["WildCard"]=f_dec2ip($dWildCard);

  $IpAll["Cidr"]=f_dec2cidr($dMask);

  $IpAll["Bcast"]=f_dec2ip(f_or($dNet,$dWildCard));

  $IpAll["nIp"]=$dWildCard+1;

  $IpAll["nIpUtil"]=$dWildCard-1;

  if($IpAll["nIp"] > 2){

        $IpAll["IpFrom"]=f_dec2ip($dNet+1);

        $IpAll["IpTo"]=f_dec2ip($dNet+$dWildCard-1);

  }

  else

  {

        $IpAll["IpFrom"]="-";

        $IpAll["IpTo"]="-";

        $IpAll["nIpUtil"]=0;

  }

  return $IpAll;

}



?>



=============================================================

GMP install steps in Mandrake 9.1: 

----------------------------------------------------------

cp -r /usr/src/php-devel/extensions/gmp /tmp/gmp

cd /tmp/gmp

phpize

./configure

make install

echo "extension = gmp.so" > /etc/php/90_gmp.ini



Restart apache web server.

----------------------------------------------------------

gmp.so is in:

/usr/lib/php/extensions/



look in phpinfo, the string:

/etc/php/90_gmp.ini 



Needs these tools:

autoconf

automake

libtool

m4

php430-devel-430-11mdk.rpm

all rpm´s that are envolved to run and compile gmp (*gmp*.rpm)



Some docs about self contained extensions:

/usr/share/doc/php430-devel-430/SELF-CONTAINED-EXTENSIONS

=============================================================