文字列をランダムにシャッフルする

# str_shuffle

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

str_shuffle — 文字列をランダムにシャッフルする

### 説明

str_shuffle ( string `$str` ) : string

str_shuffle() は文字列をシャッフルします。 考えられるすべての順列のうちのひとつを作成します。

警告

この関数が生成する値は、暗号学的に安全ではありません。そのため、これを暗号として使ってはいけません。暗号学的に安全な値が必要な場合は、random_int() か random_bytes() あるいは openssl_random_pseudo_bytes() を使いましょう。

### パラメータ

`str`

  入力文字列。

### 返り値

シャッフルされた文字列を返します。

### 変更履歴

バージョン | 説明
--- | ---
7.1.0 | The internal randomization algorithm has been changed to use the » Mersenne Twister Random Number Generator instead of the libc rand function.

### 例

例1 str_shuffle() の例

`<?php
$str = 'abcdef';
$shuffled = str_shuffle($str);
// bfdaec のような文字列を返します
echo $shuffled;
?>`

### 参考

- shuffle() - 配列をシャッフルする
- rand() - 乱数を生成する