gmp_random_seed

Sets the RNG seed

&reftitle.description; `void` `gmp_random_seed` ``GMP``int``string```seed`
&reftitle.parameters;

`seed`

- The seed to be set for the `gmp_random`, `gmp_random_bits`, and `gmp_random_range` functions.

  &gmp.parameter;
&reftitle.returnvalues;

&return.void;

&reftitle.errors;

Throws a `ValueError` if `seed` is invalid.

&reftitle.changelog;

&Version; | &Description;
8.0.0 | If `seed` is invalid, `gmp_random_seed` now throws a `ValueError`. Previously it emitted an `E_WARNING` and returned &false;.

&reftitle.examples;

### `gmp_random_seed` example

    <?php
    // set the seed
    gmp_random_seed(100);

    var_dump(gmp_strval(gmp_random(1)));

    // set the seed to something else
    gmp_random_seed(gmp_init(-100));

    var_dump(gmp_strval(gmp_random_bits(10)));

    // set the seed to something invalid
    var_dump(gmp_random_seed('not a number'));

&example.outputs;

    string(20) "15370156633245019617"
    string(3) "683"

    Warning: gmp_random_seed(): Unable to convert variable to GMP - string is not an integer in %s on line %d
    bool(false)

&reftitle.seealso;

- `gmp_init`
- `gmp_random`
- `gmp_random_bits`
- `gmp_random_range`