preg_splitZerlegt eine Zeichenkette anhand eines regulären Ausdrucks
&reftitle.description;
arrayfalsepreg_splitstringpatternstringsubjectintlimit-1intflags0
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".
flagsflags 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;
preg_split-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-Suchmusterpreg_quoteexplodepreg_matchpreg_match_allpreg_replacepreg_last_error