PHP: Random\Randomizer::getBytes

Description

public Random\Randomizer::getBytes(int $length): string

Generates a string containing uniformly selected random bytes with the requested length.

As the returned bytes are selected completely randomly, the resulting string is likely to contain unprintable characters or invalid UTF-8 sequences. It may be necessary to encode it before transmission or display.

Parameters

length: The length of the random string that should be returned in bytes; must be 1 or greater.

Return Values

A string containing the requested number of random bytes.

Errors/Exceptions

If the value of length is less than 1, a ValueError will be thrown.
Any Throwables thrown by the Random\Engine::generate() method of the underlying Random\Randomizer::$engine.

Examples

Example #1 Random\Randomizer::getBytes() example

<?php
$r = new \Random\Randomizer();

echo bin2hex($r->getBytes(8)), "\n";
?>

The above example will output something similar to:

ebdbe93cd56682c2

Random\Randomizer::getBytes

Description

Parameters

Return Values

Errors/Exceptions

Examples

See Also

Found A Problem?

User Contributed Notes