Random\Randomizer::getBytes
(PHP 8 >= 8.2.0)
Random\Randomizer::getBytes — ランダムなバイト列を取得する
説明
等確率に選ばれるランダムなバイト列を含む、指定された長さ length の文字列を生成します。
返されるバイト列は完全にランダムに選ばれるため、 結果の文字列は印字できない文字や、 不正な UTF-8 のシーケンスとなる可能性があります。 よって、転送したり表示したりする時にはエンコードが必要かもしれません。
パラメータ
-
length -
返すべきランダムな文字列の長さをバイト単位で指定します。
1以上でなければなりません。
戻り値
指定された長さの、ランダムなバイト列を含んだ文字列を返します。
エラー / 例外
-
lengthの値が1より小さい場合、 ValueError をスローします。 -
Random\Randomizer::$engineに存在する Random\Engine::generate() メソッド がスローした、あらゆる Throwable がスローされます。
例
例1 Random\Randomizer::getBytes() の例
<?php
$r = new \Random\Randomizer();
echo bin2hex($r->getBytes(8)), "\n";
?>上の例の出力は、 たとえば以下のようになります。
ebdbe93cd56682c2
参考
- random_bytes() - 暗号学的にセキュアな、ランダムなバイト列を生成する
- base64_encode() - MIME base64 方式でデータをエンコードする
- Random\Randomizer::getBytesFromString() - 文字列からランダムにバイト列を取得する
add a note
User Contributed Notes
There are no user contributed notes for this page.
