array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.str-shuffle.php', 1 => 'str_shuffle', 2 => 'Mischt einen String nach dem Zufallsprinzip', ), 'up' => array ( 0 => 'ref.strings.php', 1 => 'String-Funktionen', ), 'prev' => array ( 0 => 'function.str-rot13.php', 1 => 'str_rot13', ), 'next' => array ( 0 => 'function.str-split.php', 1 => 'str_split', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/strings/functions/str-shuffle.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

str_shuffle

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

str_shuffle — Mischt einen String nach dem Zufallsprinzip

Beschreibung

str_shuffle(string $string): string

str_shuffle() mischt eine Zeichenkette. Es entsteht eine Permutation aller vorhandenen Zeichen.

Achtung

Diese Funktion erzeugt keine kryptografisch sicheren Werte und darf nicht für kryptografische Zwecke verwendet werden oder für Zwecke, bei denen die zurückgegebenen Werte nicht abschätzbar sein dürfen.

Falls kryptographisch sichere Zufallszahlen benötigt werden, kann der Random\Randomizer mit der Random\Engine\Secure-Engine verwendet werden. Für einfache Anwendungsfälle bieten die Funktionen random_int() und random_bytes() eine bequeme und sichere API, die den CSPRNG des Betriebssystems verwendet.

Achtung

This function uses the global Mt19937 (“Mersenne Twister”) instance as the source of randomness and thus shares its state with all other functions using the global Mt19937. Using any of these functions advances the sequence for all the other functions, regardless of scope.

Generating repeatable sequences by seeding mt_srand() or srand() with a known value will also yield repeatable output from this function.

Prefer using Random\Randomizer methods in all newly written code.

Parameter-Liste

string

Die Eingabezeichenkette.

Rückgabewerte

Gibt die vermischte Zeichenkette zurück.

Changelog

Version Beschreibung
7.1.0 Der interne Zufallsalgorithmus wurde geändert, und verwendet nun den » Mersenne Twister Zufallszahlengenerator statt der rand Funktion von libc.

Beispiele

Beispiel #1 str_shuffle()-Beispiel

<?php
$str = 'abcdef';
$shuffled = str_shuffle($str);

// erzeugt eine Ausgabe wie: bfdaec
echo $shuffled;
?>

Siehe auch