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(), які забезпечують зручний і безпечний API до системного CSPRNG.

    Параметри

    array

    Масив.

    Значення, що повертаються

    Завжди повертає true.

    Журнал змін

    Версія Опис
    7.1.0 Внутрішній алгоритм випадковостей було змінено на » Вихор Мерсенна замість функції rand з бібліотеки libc.

    Приклади

    Приклад #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