# gmp_random_bits

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

gmp_random_bits — Random number

### Descripción

gmp_random_bits(int `$bits`): GMP

Generate a random number. The number will be between `0` and `2$bits - 1`.

`bits` must greater than 0, and the maximum value is restricted by available memory.

Precaución

Esta función no genera valores criptográficos fiables por lo que no debería empelarse para propósitos criptográficos. Si fuera necesario un valor criptográfico seguro, considérese utilizar random_int(), random_bytes(), o openssl_random_pseudo_bytes() en su lugar.

### Parámetros

`bits`

  The number of bits to generate.

### Valores devueltos

A random GMP number.

### Errores/Excepciones

If `bits` is less than `1`, a ValueError will be thrown.

### Ejemplos

Ejemplo #1 gmp_random_bits() example

`<?php
$rand1 = gmp_random_bits(3); // random number from 0 to 7
$rand2 = gmp_random_bits(5); // random number from 0 to 31
echo gmp_strval($rand1) . "\n";
echo gmp_strval($rand2) . "\n";
?>`

El resultado del ejemplo sería:

    3
    15