explode
(PHP 4, PHP 5)
explode — Teilt einen String anhand einer Zeichenkette
Beschreibung
Gibt ein Array aus Strings zurück, die jeweils Teil von string sind. Die Abtrennung erfolgt dabei an der mit delimiter angegebenen Zeichenkette.
Parameter Liste
- delimiter
-
Die Begrenzungszeichenkette.
- string
-
Die Eingabezeichenkette.
- limit
-
Ist der Parameter limit angegeben, enthält das zurückgegebene Array maximal limit Elemente, wobei das letzte Element den Rest von string beinhaltet.
Ist der Parameter limit negativ, werden alle Teilstrings bis auf die letzten -limit Teile zurückgegeben.
Obgleich implode() aus historischen Gründen die Parameter in anderer Reihenfolge akzeptiert, verarbeitet explode() ausschließlich die hier angegebene Reihenfolge. Stellen Sie daher sicher, dass Sie den Parameter delimiter vor dem Parameter string notieren.
Rückgabewerte
Ist delimiter ein leerer String (""), so gibt explode() FALSE zurück. Enthält delimiter einen Wert, der nicht in string vorkommt, gibt explode() ein Array zurück, das den string als einziges Element enthält.
ChangeLog
Version | Beschreibung |
---|---|
5.1.0 | Die Unterstützung für negative limit -Werte wurde hinzugefügt. |
4.0.1 | Der Parameter limit wurde hinzugefügt. |
Beispiele
Example#1 explode()-Beispiele
<?php
// Beispiel 1
$pizza = "Teil1 Teil2 Teil3 Teil4 Teil5 Teil6";
$teile = explode(" ", $pizza);
echo $teile[0]; // Teil1
echo $teile[1]; // Teil2
// Beispiel 2
$data = "foo:*:1023:1000::/home/foo:/bin/sh";
list($user, $pass, $uid, $gid, $gecos, $home, $shell) = explode(":", $data);
echo $user; // foo
echo $pass; // *
?>
Example#2 limit -Parameterbeispiele
<?php
$str = 'eins|zwei|drei|vier';
// positiver Wert in "limit"
print_r(explode('|', $str, 2));
// negative Wert in "limit" (ab PHP 5.1)
print_r(explode('|', $str, -1));
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
Array ( [0] => eins [1] => zwei|drei|vier ) Array ( [0] => eins [1] => zwei [2] => drei )
Anmerkungen
Hinweis: Diese Funktion ist binary safe.