preg_split Zerlegt eine Zeichenkette anhand eines regulären Ausdrucks &reftitle.description; arrayfalsepreg_split stringpattern stringsubject intlimit-1 intflags0 Zerlegt die angegebene Zeichenkette anhand eines regulären Ausdrucks. &reftitle.parameters; pattern Der Ausdruck, nach dem gesucht werden soll, als Zeichenkette. subject Die zu zerlegende Zeichenkette. limit Falls angegeben, werden maximal limit Teilzeichenketten zurückgegeben, wobei der Rest der Zeichenkette in der letzten Teilzeichenkette abgelegt wird. Ein limit von -1 oder 0 bedeutet "kein Limit". flags flags kann jede Kombination der folgenden Flags sein (verknüpft mit dem bitweisen | Operator): PREG_SPLIT_NO_EMPTY Falls dieses Flag gesetzt ist, werden von preg_split nur die Teile zurückgegeben, die nicht leer sind. PREG_SPLIT_DELIM_CAPTURE Falls dieses Flag gesetzt ist, werden auch die eingeklammerten Ausdrücke des Trennsymbol-Suchmusters erfasst und zurückgegeben. PREG_SPLIT_OFFSET_CAPTURE Falls dieses Flag gesetzt ist, wird mit jeder gefundenen Übereinstimmung die dazugehörige Position in der Zeichenkette zurückgegeben. Zu beachten ist, dass dies die Rückgabewerte in einem Array dahingehend ändert, dass jedes Element ein Array ist, das aus der übereinstimmenden Zeichenkette als Element 0 und deren Stelle in subject als Element 1 besteht. &reftitle.returnvalues; Gibt ein Array zurück, bestehend aus Teilzeichenketten der Zeichenkette subject, die an den auf das Suchmuster pattern passenden Stellen zerlegt wurde. &return.falseforfailure; &reftitle.errors; &pcre.pattern.warning; &reftitle.examples; <function>preg_split</function>-Beispiel: Eine Zeichenkette in Teile zerlegen ]]> &example.outputs; hypertext [1] => language [2] => programming ) ]]> Eine Zeichenkette in einzelne Zeichen zerlegen ]]> &example.outputs; s [1] => t [2] => r [3] => i [4] => n [5] => g ) ]]> Zerlegen einer Zeichenkette in Suchtreffer und Erfassen der Positionen ]]> &example.outputs; Array ( [0] => hypertext [1] => 0 ) [1] => Array ( [0] => language [1] => 10 ) [2] => Array ( [0] => programming [1] => 19 ) ) ]]> &reftitle.notes; Falls die Leistungsfähigkeit regulärer Ausdrücke nicht benötigt wird, können stattdessen schnellere (und gleichzeitig einfachere) Alternativen wie explode oder str_split verwendet werden. Falls keine Übereinstimmungen gefunden wurden, wird ein Array mit nur einem Element zurückgegeben, das die übergebene Zeichenkette enthält. &reftitle.seealso; PCRE-Suchmuster preg_quote explode preg_match preg_match_all preg_replace preg_last_error