gmp_random

Random number

&warn.deprecated.function-7-2-0.removed-8-0-0;
&reftitle.description; `GMP` `gmp_random` `int` `limiter` 20

Generate a random number. The number will be between 0 and (2 ** n) - 1, where n is the number of bits per limb multiplied by `limiter`. If `limiter` is negative, negative numbers are generated.

A limb is an internal GMP mechanism. The number of bits in a limb is not static, and can vary from system to system. Generally, the number of bits in a limb is either 32 or 64, but this is not guaranteed.

&caution.cryptographically-insecure;
&reftitle.parameters;

`limiter`

- The limiter.

  &gmp.parameter;
&reftitle.returnvalues;

A random GMP number.

&reftitle.examples;

### `gmp_random` example

    <?php
    $rand1 = gmp_random(1); // random number from 0 to 1 * bits per limb
    $rand2 = gmp_random(2); // random number from 0 to 2 * bits per limb

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

&example.outputs;

    1915834968
    8642564075890328087