str_shuffle
str_shuffle
(PHP 4 >= 4.3.0, PHP 5, PHP 7)
str_shuffle — Randomly shuffles a string
Description
string str_shuffle ( string $str )
str_shuffle() shuffles a string. One permutation of all possible is created.
Caution
This function does not generate cryptographically secure values, and should not be used for cryptographic purposes. If you need a cryptographically secure value, consider using random_int(), random_bytes(), or openssl_random_pseudo_bytes() instead.
Parameters
-
str -
The input string.
Return Values
Returns the shuffled string.
Changelog
| Version | Description |
|---|---|
| 7.1.0 | The internal randomization algorithm has been changed to use the » Mersenne Twister Random Number Generator instead of the libc rand function. |
Examples
Example #1 str_shuffle() example
<?php $str = 'abcdef'; $shuffled = str_shuffle($str); // This will echo something like: bfdaec echo $shuffled; ?>
© 1997–2017 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://secure.php.net/manual/en/function.str-shuffle.php
