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 が指定されると、
Error がスローされます。
&reftitle.changelog;
&Version;
&Description;
8.2.0
CSPRNG が失敗した場合に、
Random\RandomException をスローするようになりました。
これより前のバージョンでは、Exception をスローしていました。
&reftitle.examples;
random_bytes の例
]]>
&example.outputs.similar;
&reftitle.seealso;
Random\Randomizer::getBytes
random_int
bin2hex
base64_encode