(PHP 4, PHP 5, PHP 7, PHP 8)
rand — Generate a random integer
DescriptionIf called without the optional min
, max
arguments rand() returns a pseudo-random integer between 0 and getrandmax(). If you want a random number between 5 and 15 (inclusive), for example, use rand(5, 15)
.
This function does not generate cryptographically secure values, and must not be used for cryptographic purposes, or purposes that require returned values to be unguessable.
If cryptographically secure randomness is required, the Random\Randomizer may be used with the Random\Engine\Secure engine. For simple use cases, the random_int() and random_bytes() functions provide a convenient and secure API that is backed by the operating system’s CSPRNG.
Note: Prior to PHP 7.1.0, getrandmax() was only 32767 on some platforms (such as Windows). If you require a range larger than 32767, specifying
min
andmax
will allow you to create a range larger than this, or consider using mt_rand() instead.
ParametersNote: As of PHP 7.1.0, rand() uses the same random number generator as mt_rand(). To preserve backwards compatibility rand() allows
max
to be smaller thanmin
as opposed to returningfalse
as mt_rand().
min
The lowest value to return (default: 0)
max
The highest value to return (default: getrandmax())
A pseudo random value between min
(or 0) and max
(or getrandmax(), inclusive).
Example #1 rand() example
<?php
echo rand(), "\n";
echo rand(), "\n";
echo
rand(5, 15), "\n";
?>
The above example will output something similar to:
Notes Warningmin
max
range must be within the range getrandmax(). i.e. (max
- min
) <= getrandmax() Otherwise, rand() may return poor-quality random numbers.
There are no user contributed notes for this page.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.3