php8.5
Home/ Manual/ gmp / functions/ gmp_random

gmp_random

PHP function Deprecated as of PHP 7.2.0 Edit on GitHub ✎

(PHP 4 >= 4.0.4, PHP 5, PHP 7)

Random number

Removed-8-0-0

Description

gmp_random(int $limiter = 20): GMP

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.

Cryptographically-insecure

Parameters

limiter

The limiter.

Parameter

Return Values

A random GMP number.

Examples

gmp_random() example

php
<?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";
?>

The above example will output:

output
1915834968
8642564075890328087

Source: reference/gmp/functions/gmp-random.xml · from the official PHP manual (php/doc-en)