Random\Randomizer::getBytes

(PHP 8 >= 8.2.0)

Random\Randomizer::getBytes — Получает случайные байты

Описание

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

Создаёт строку, содержащую равномерно выбранные случайные байты с запрошенной длиной length.

Поскольку возвращаемые байты выбираются совершенно случайно, полученная строка может содержать непечатаемые символы или недопустимые последовательности UTF-8. Может потребоваться её кодирование перед передачей или отображением.

Список параметров

length: Длина случайной строки (string), которая должна быть возвращена, в байтах. Значение должно быть больше или равно 1.

Возвращаемые значения

Возвращает строку (string), содержащую запрошенное количество случайных байтов.

Ошибки

Если значение параметра length меньше 1, будет выброшена ошибка ValueError.
Любые Throwable, выбрасываемые методом Random\Engine::generate() базового Random\Randomizer::$engine.

Примеры

Пример #1 Пример использования Random\Randomizer::getBytes()

<?php

$r = new \Random\Randomizer();

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

Вывод приведённого примера будет похож на:

ebdbe93cd56682c2

Смотрите также

random_bytes() - Получает криптографически безопасные случайные байты
bin2hex() - Преобразовывает бинарные данные в шестнадцатеричное представление
base64_encode() - Кодирует данные в формат MIME base64
Random\Randomizer::getBytesFromString() - Получает случайные байты из исходной строки

add a note

User Contributed Notes

There are no user contributed notes for this page.