random_bytes
Получает криптографически безопасные случайные байты
&reftitle.description;
stringrandom_bytes
intlength
Функция создаёт строку, которая содержит равномерно выбранные случайные байты с запрошенной длиной length.
Поскольку возвращаемые байты выбираются совершенно случайно,
полученная строка может содержать непечатаемые символы или недопустимые последовательности UTF-8.
Может потребоваться её кодирование перед передачей или отображением.
Случайная последовательность, которую создаёт функция, подходит для всех приложений,
включая генерацию долгосрочных секретов, таких как ключи шифрования.
&csprng.sources;
&csprng.function.backport;
&reftitle.parameters;
length
Длина генерируемой строки в байтах; значение должно быть равно или больше 1.
&reftitle.returnvalues;
Функция возвращает строку, которая состоит из заданного количества криптографически безопасных байтов.
&reftitle.errors;
&csprng.errors;
Если значение параметра length меньше 1,
будет выброшена ошибка ValueError.
&reftitle.changelog;
&Version;
&Description;
8.2.0
В случае возникновения ошибки CSPRNG,
функция теперь будет выбрасывать исключение Random\RandomException.
Ранее выбрасывалось исключение Exception.
&reftitle.examples;
Пример использования <function>random_bytes</function>
]]>
&example.outputs.similar;
&reftitle.seealso;
Random\Randomizer::getBytes
random_int
bin2hex
base64_encode