array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.gmp-random-bits.php', 1 => 'gmp_random_bits', 2 => 'Genera un número aleatorio', ), 'up' => array ( 0 => 'ref.gmp.php', 1 => 'Funciones de GMP', ), 'prev' => array ( 0 => 'function.gmp-random.php', 1 => 'gmp_random', ), 'next' => array ( 0 => 'function.gmp-random-range.php', 1 => 'gmp_random_range', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/gmp/functions/gmp-random-bits.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

gmp_random_bits

(PHP 5 >= 5.6.3, PHP 7, PHP 8)

gmp_random_bits — Genera un número aleatorio

Descripción

gmp_random_bits(int $bits): GMP

Genera un número aleatorio. El número estará en el intervalo 0 y 2$bits - 1.

El argumento bits debe ser mayor que 0, y el valor máximo estará restringido por la memoria disponible.

Precaución

Esta función no genera valores criptográficamente seguros, y no debe ser utilizada con fines criptográficos, o con fines que requieran que los valores devueltos sean indescifrables.

Si se requiere aleatoriedad criptográficamente segura, el Random\Randomizer puede ser utilizado con el motor Random\Engine\Secure. Para casos de uso simples, las funciones random_int() y random_bytes() proporcionan una API práctica y segura que es soportada por el CSPRNG del sistema operativo.

Parámetros

bits

El número de bits a generar.

Valores devueltos

Un número GMP aleatorio.

Errores/Excepciones

Si bits es menor que 1, se lanzará una ValueError.

Ejemplos

Ejemplo #1 Ejemplo con gmp_random_bits()

<?php
$rand1 = gmp_random_bits(3); // número aleatorio entre 0 y 7
$rand2 = gmp_random_bits(5); // número aleatorio entre 0 y 31

echo gmp_strval($rand1) . "\n";
echo gmp_strval($rand2) . "\n";
?>

El ejemplo anterior mostrará:

3
15