Shuffle()

shuffle

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

shuffle — Blanda en array

Beskrivning

shuffle(array &$array): true

Denna funktion blandar (randomiserar ordningen på elementen i) en array.

Varning

Denna funktion genererar inte kryptografiskt säkra värden och får inte användas för kryptografiska ändamål eller ändamål som kräver att de returnerade värdena är oförutsägbara.

Om kryptografiskt säker slumpmässighet krävs kan Random\Randomizer användas med Random\Engine\Secure-motorn. För enkla användningsfall ger funktionerna random_int() och random_bytes() ett praktiskt och säkert API som stöds av operativsystemets CSPRNG.

Parametrar

array

Arrayen.

Returvärden

Returnerar alltid true.

Ändringslogg

Version Beskrivning

7.1.0 Den interna slumpgenereringsalgoritmen har ändrats till att använda » Mersenne Twister Random Number Generator istället för libc rand-funktionen.

Exempel

Exempel #1 shuffle()-exempel

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

Noteringar

• Notera: Denna funktion tilldelar nya nycklar till elementen i arrayen. Den kommer att ta bort eventuella befintliga nycklar som tilldelats, snarare än att bara omordna nycklarna.
• Notera: Återställer arrayens interna pekare till det första elementet.

Se även

• Random\Randomizer::shuffleArray() - Få en permutation av en array
• Random\Randomizer::shuffleBytes() - Få en bytevis permutation av en sträng
• Random\Randomizer::pickArrayKeys() - Välj slumpmässiga arraynycklar
• Sortering av Arrayer - Jämförelse av arraysorteringsfunktioner