(PHP 4, PHP 5)
preg_split — Zerlegt eine Zeichenkette anhand eines regulären Ausdrucks
Zerlegt die angegebene Zeichenkette anhand eines regulären Ausdrucks.
Der Ausdruck nach dem gesucht werden soll als Zeichenkette
Die zu zerlegende Zeichenkette
Falls angegeben, werden maximal Limit Teilzeichenketten zurückgegeben und falls Limit -1 ist, bedeutet das "kein Limit", was für die Angabe von Flags sinnvoll ist.
Flags kann jede Kombination der folgenden Flags sein (verknüpft mit dem bitweisen | Operator):
Falls dieses Flag gesetzt ist, wird mit jeder gefundenen Übereinstimmung der dazugehörige Versatz in der Zeichenkette zurückgegeben. Beachten Sie, 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 Zeichenkette als Element 1 besteht.
Gibt ein Array zurück, bestehend aus Teilzeichenketten der Zeichenkette , die an den auf das Suchmuster passenden Stellen zerlegt wurde.
Version | Beschreibung |
---|---|
4.3.0 | Das Flag PREG_SPLIT_OFFSET_CAPTURE hinzugefügt |
4.0.5 | Das Flag PREG_SPLIT_DELIM_CAPTURE hinzugefügt |
4.0.0 | Den Parameter Flags hinzugefügt |
Example#1 preg_split() Beispiel: Eine Zeichenkette in ihre Bestandteile zerlegen
<?php
// zerlegt die Zeichenkette an Stellen mit beliebiger Anzahl von
// Kommata oder Leerzeichen, die " ", \r, \t, \n und \f umfassen
$schluesselwoerter = preg_split("/[\s,]+/", "hypertext language, programming");
?>
Example#2 Eine Zeichenkette in einzelne Zeichen zerlegen
<?php
$str = 'Zeichenkette';
$zeichen = preg_split('//', $str, -1, PREG_SPLIT_NO_EMPTY);
print_r($zeichen);
?>
Example#3 Eine Zeichenkette in Übereinstimmungen mit dem Suchmuster und deren Versatz zerlegen
<?php
$str = 'hypertext language programming';
$zeichen = preg_split('/ /', $str, -1, PREG_SPLIT_OFFSET_CAPTURE);
print_r($zeichen);
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Array ( [0] => Array ( [0] => hypertext [1] => 0 ) [1] => Array ( [0] => language [1] => 10 ) [2] => Array ( [0] => programming [1] => 19 ) )
Falls Sie die Leistung regulärer Ausdrücke nicht benötigen, können Sie stattdessen schnellere (wenngleich einfachere) Alternativen wie explode() oder str_split() verwenden.