Loader

str_shuffle

str_shuffle() shuffles a string. One permutation of all possible is created. Test str_shuffle online.

string str_shuffle ( string $str )

PHP Documentation by the PHP Documentation Group

str_shuffle

(PHP 4 >= 4.3.0, PHP 5, PHP 7)

str_shuffleRandomly shuffles a string

Description

str_shuffle ( string $str ) : string

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;
?>

See Also

PHP Documentation

Copyright © 1997 - 2016 by the PHP Documentation Group. This material may be distributed only subject to the terms and conditions set forth in the Creative Commons Attribution 3.0 License or later. A copy of the Creative Commons Attribution 3.0 license is distributed with this manual. The latest version is presently available at » http://creativecommons.org/licenses/by/3.0/.