(PHP 4 >= 4.0.1, PHP 5)
spliti — Zerlegt eine Zeichenkette anhand eines regulären Ausdrucks ohne Berücksichtigung von Groß-/Kleinschreibung in ein Array
$pattern
, string $string
[, int $limit = -1
] )
Zerlegt string anhand eines regulären Ausdrucks in
ein Array.
Diese Funktion entspricht split() mit dem Unterschied, dass sie übereinstimmende Buchstaben nicht nach Groß- und Kleinschreibung unterscheidet.
Diese Funktion ist seit PHP 5.3.0 DEPRECATED (veraltet). Sich auf diese Funktion zu verlassen ist in keiner Weise empfehlenswert.
patternRegulärer Ausdruck ohne Berücksichtigung der Groß- und Kleinschreibung
Wenn Sie eine Zerlegung an Zeichen vornehmen, die in regulären Ausdrücken als besondere Zeichen betrachtet werden, müssen Sie diese entsprechend kennzeichnen. Wenn Sie der Ansicht sind, spliti() (oder, bei diesem Thema, eine andere Regex-Funktion) verhalte sich seltsam, lesen Sie bitte die Datei regex.7, die sich im regex/ Unterverzeichnis ihrer PHP-Distribution befindet. Da sie im manpage-Fomat vorliegt, sollten Sie einen Befehl der Art man /usr/local/src/regex/regex.7 verwenden, um sie zu lesen.
stringDie zu durchsuchende Zeichenkette
limit
Wenn limit gesetzt wurde, enthält das
zurückgegebene Array höchstens limit Elemente,
von denen das letzte den ganzen Rest von string
enthält.
Gibt ein Array mit Zeichenketten zurück, die jeweils eine Teilzeichenkette
von string sind. Diese Teilzeichenketten entstehen
durch Zerlegung von string an den durch den
regulären Ausdruck pattern bestimmten Stellen ohne
Berücksichtigung der Groß- und Kleinschreibung.
Wenn pattern n mal
vorkommt, enhält das zurückgegebene Array
n+1 Elemente. Kommt
pattern zum Beispiel überhaupt nicht vor, wird ein
Array mit nur einem Element zurückgegeben. Das gilt natürlich auch, wenn
string leer ist. Bei Auftreten eines Fehlers gibt
spliti() FALSE zurück.
Dieses Beispiel verwendet 'a' als Trennzeichen um eine Zeichenkette zu zerlegen:
Beispiel #1 spliti()-Beispiel
<?php
$zeichenkette = "aBBBaCCCADDDaEEEaGGGA";
$stuecke = spliti ("a", $zeichenkette, 5);
print_r($stuecke);
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Array ( [0] => [1] => BBB [2] => CCC [3] => DDD [4] => EEEaGGGA )
Hinweis:
Seit PHP 5.3.0 ist die regex-Erweiterung zugunsten der PCRE-Erweiterung als veraltete markiert. Ein Aufruf dieser Funktion wird eine
E_DEPRECATED-Notice ausgeben. Sie können sich die Liste der Unterschiede ansehen, wenn Sie Hilfe beim Umstieg auf PCRE benötigen.
spliti() ist ab PHP 5.3.0 veraltet. Verwenden Sie
stattdessen preg_split() mit dem Modifikator
i (PCRE_CASELESS).