PHP Dokumentation: Function spliti
12. Januar 2010 von werner
spliti
(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
Beschreibung
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 istseit PHP 5.3.0 DEPRECATED (veraltet) und wirdin PHP 6.0.0 ENTFERNT. Sich auf diese Funktionzu verlassen ist in keiner Weise empfehlenswert.
Parameter-Liste
- pattern
Regulä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.
- string
Die 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.
Rückgabewerte
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.
Beispiele
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 folgendeAusgabe:
Array( [0] => [1] => BBB [2] => CCC [3] => DDD [4] => EEEaGGGA)
Anmerkungen
Hinweis: As of PHP 5.3.0, theregex extension is deprecated in favor of the PCRE extension. Calling this function will issue an E_DEPRECATED notice.
Siehe auch
- preg_split() – Zerlegt eine Zeichenkette anhand eines regulären Ausdrucks
- split() – Zerlegt eine Zeichenkette anhand eines regulären Ausdrucks in ein Array
- explode() – Teilt einen String anhand einer Zeichenkette
- implode() – Verbindet Array-Elemente zu einem String