Random\Randomizer::getBytes

(PHP 8 >= 8.2.0)

Random\Randomizer::getBytes — Get random bytes

Beschreibung

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.

Parameter-Liste

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

Rückgabewerte

A String containing the requested number of random bytes.

Fehler/Exceptions

If the value of length is less than 1, a ValueError will be thrown.
Alle Throwables, die von der Methode Random\Engine::generate() der zugrundeliegenden Random\Randomizer::$engine ausgelöst werden.

Beispiele

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

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

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

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

ebdbe93cd56682c2

Siehe auch

random_bytes() - Get cryptographically secure random bytes
bin2hex() - Wandelt Binär-Daten in ihre hexadezimale Entsprechung um
base64_encode() - Kodiert Daten MIME base64
Random\Randomizer::getBytesFromString() - Get random bytes from a source string

add a note

User Contributed Notes

There are no user contributed notes for this page.