array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'random-randomizer.getbytes.php', 1 => 'Random\\Randomizer::getBytes', 2 => 'ランダムなバイト列を取得する', ), 'up' => array ( 0 => 'class.random-randomizer.php', 1 => 'Random\\Randomizer', ), 'prev' => array ( 0 => 'random-randomizer.construct.php', 1 => 'Random\\Randomizer::__construct', ), 'next' => array ( 0 => 'random-randomizer.getbytesfromstring.php', 1 => 'Random\\Randomizer::getBytesFromString', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/random/random/randomizer/getbytes.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Random\Randomizer::getBytes

(PHP 8 >= 8.2.0)

Random\Randomizer::getBytes — ランダムなバイト列を取得する

説明

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

等確率に選ばれるランダムなバイト列を含む、指定された長さ length の文字列を生成します。

返されるバイト列は完全にランダムに選ばれるため、 結果の文字列は印字できない文字や、 不正な UTF-8 のシーケンスとなる可能性があります。 よって、転送したり表示したりする時にはエンコードが必要かもしれません。

パラメータ

length

返すべきランダムな文字列の長さをバイト単位で指定します。1 以上でなければなりません。

戻り値

指定された長さの、ランダムなバイト列を含んだ文字列を返します。

エラー / 例外

例

例1 Random\Randomizer::getBytes() の例

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

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

上の例の出力は、 たとえば以下のようになります。

ebdbe93cd56682c2

参考