update page now

    shuffle

    (PHP 4, PHP 5, PHP 7, PHP 8)

    shuffle — 配列をシャッフルする

    説明

    shuffle(array &$array): true

    この関数は、配列をシャッフル (要素の順番をランダムに) します。

    警告

    この関数が生成する値は、暗号学的にセキュアではありません。そのため、これを暗号や、戻り値を推測できないことが必須の値として使っては いけません。

    暗号学的にセキュアな乱数が必要な場合は、Random\Randomizer を Random\Engine\Secure と一緒に使いましょう。簡単なユースケースの場合、random_int() と random_bytes() 関数が、オペレーティングシステムの CSPRNG を使った、 便利で安全な API を提供します。

    パラメータ

    array

    配列。

    戻り値

    常に true を返します。

    変更履歴

    バージョン 説明
    7.1.0 内部的なランダム化のアルゴリズムが、 libc の rand 関数ではなく、 » メルセンヌツイスタ 乱数生成器 を使うように 変更されました。

    例

    例1 shuffle() の例

    <?php
    $numbers     = range(1, 20);
    shuffle($numbers);
    foreach (    $numbers as $number) {
    echo     "$number ";
    }
    ?>

    注意

    注意: この関数は、 array パラメータの要素に対して新しいキーを割り当てます。 その際、単純にキーを並べ替える代わりに、 すでに割り当てられている既存のキーを削除してしまいます。

    注意:

    この関数をコールすると、配列の内部ポインタは最初の要素にリセットされます。

    参考

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 2 notes

    up
    135
    ahmad at ahmadnassri dot com
    16 years ago
    shuffle for associative arrays, preserves key=>value pairs.
(Based on (Vladimir Kornea of typetango.com)'s function) 

<?php
    function shuffle_assoc(&$array) {
        $keys = array_keys($array);

        shuffle($keys);

        foreach($keys as $key) {
            $new[$key] = $array[$key];
        }

        $array = $new;

        return true;
    }
?>

*note: as of PHP 5.2.10, array_rand's resulting array of keys is no longer shuffled, so we use array_keys + shuffle.
    up
    4
    pineappleclock at gmail dot com
    17 years ago
    If you want the Power Set (set of all unique subsets) of an array instead of permutations, you can use this simple algorithm:

<?php
/**
* Returns the power set of a one dimensional array,
* a 2-D array.
* array(a,b,c) ->
* array(array(a),array(b),array(c),array(a,b),array(b,c),array(a,b,c))
*/
function powerSet($in,$minLength = 1) { 
   $count = count($in); 
   $members = pow(2,$count); 
   $return = array();
   for ($i = 0; $i < $members; $i++) {
      $b = sprintf("%0".$count."b",$i);
      $out = array();
      for ($j = 0; $j < $count; $j++) {
         if ($b{$j} == '1') $out[] = $in[$j];
      }
      if (count($out) >= $minLength) {
         $return[] = $out;
      }
   }
   return $return;
}
?>
    ＋add a note
    To Top