array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ja', ), 'this' => array ( 0 => 'random-randomizer.shufflearray.php', 1 => 'Random\\Randomizer::shuffleArray', 2 => '配列の順列を取得する', ), 'up' => array ( 0 => 'class.random-randomizer.php', 1 => 'Random\\Randomizer', ), 'prev' => array ( 0 => 'random-randomizer.serialize.php', 1 => 'Random\\Randomizer::__serialize', ), 'next' => array ( 0 => 'random-randomizer.shufflebytes.php', 1 => 'Random\\Randomizer::shuffleBytes', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ja', 'path' => 'reference/random/random/randomizer/shufflearray.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Random\Randomizer::shuffleArray

(PHP 8 >= 8.2.0)

Random\Randomizer::shuffleArray — 配列の順列を取得する

説明

public Random\Randomizer::shuffleArray(array $array): array

指定された array のあり得る順列から、 等確率に選ばれた順列を返します。

指定された array のあり得る順列それぞれが、返される確率は等しくなります。

パラメータ

array

値をシャッフルする配列

指定された配列は変更されません。

戻り値

array の値の順列を返します。

指定された array のキーは保存されません。 つまり、返される配列はリスト (array_is_list()) になります。

エラー / 例外

例

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

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

$fruits = [ 'red' => '🍎', 'green' => '🥝', 'yellow' => '🍌', 'pink' => '🍑', 'purple' => '🍇' ];

// 配列をシャッフルします
echo "Salad: ", implode(', ', $r->shuffleArray($fruits)), "\n";

// 再度シャッフルします
echo "Another Salad: ", implode(', ', $r->shuffleArray($fruits)), "\n";
?>

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

Salad: 🍎, 🥝, 🍇, 🍌, 🍑
Another Salad: 🍑, 🍇, 🥝, 🍎, 🍌