Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                

shuffle

(PHP 4, PHP 5, PHP 7)

shuffleShuffle an array

Description

bool shuffle ( array &$array )

This function shuffles (randomizes the order of the elements in) an array. It uses a pseudo random number generator that is not suitable for cryptographic purposes.

Note:

If two members compare as equal, their relative order in the sorted array is undefined.

Parameters

array

The array.

Return Values

Returns TRUE on success or FALSE on failure.

Examples

Example #1 shuffle() example

<?php
$numbers 
range(120);
shuffle($numbers);
foreach (
$numbers as $number) {
    echo 
"$number ";
}
?>

Notes

Note: This function assigns new keys to the elements in array. It will remove any existing keys that may have been assigned, rather than just reordering the keys.

See Also